Blender Launcher V2版本搜索语法进阶教程：用^、*、-和Build Hash精准定位任意构建
【免费下载链接】Blender-Launcher-V2Standalone client for managing official builds of Blender 3D and its popular forks项目地址: https://gitcode.com/gh_mirrors/bl/Blender-Launcher-V2
Blender Launcher V2是一款独立的 Blender 3D 构建管理客户端，可一键下载、管理和启动 Blender 官方 Stable、Daily、Experimental 构建及其热门分支（如 Bforartists、UPBGE）。它内置了一套版本搜索语法，让你用几个符号就能从数百个构建中精准锁定目标版本——这正是本教程要讲的内容。
一、搜索语法总览：一个公式读懂全部结构
打开主窗口的Library或Downloads标签页，顶部就是搜索栏。它接受两种输入：
- 精确版本查询：以版本号开头的结构化语法
- 模糊文本：普通关键词（自动容错拼写错误）
精确查询的完整格式如下：
<大版本>.<次版本>.<修订号>[-分支名][+构建哈希][@提交时间]| 组成部分 | 写法 | 是否必填 |
|---|---|---|
| 版本号三段 | 4.3.* | ✅ 必填 |
分支名- | -stable、-daily | 可选 |
Build Hash+ | +cb886aba06d5 | 可选 |
提交时间@ | @2024-07-31T23:53:51+00:00 | 可选 |
这套语法规则定义在 source/modules/version_matcher.py，界面实现在 source/widgets/search_bar/search_bar.py。
二、三个魔法符号：^、*、- 分别代表什么
版本号三段中的每一位都可以是数字，也可以替换成以下符号：
*—— 匹配任意值
表示"这一段不限"。例如：
*.*.*：匹配所有构建（通配一切的"万能搜索"）4.*.*：所有 4.x 大版本下的构建*.*.14：任意主版本中修订号为 14 的构建
^—— 匹配该位最新（最大）值
表示"取这一列里最新的"。这是最常用的高频写法：
^.*.*：当前最新大版本下的所有构建4.^.*：4.x 中最新次版本的所有构建^.*.-stable：最新版本线中的 stable 构建
-—— 匹配该位最旧（最小）值
与^方向相反，锁定"最老的那一个"。例如-.*.-stable可找到最早大版本里的最旧 stable 构建，适合做"考古"排查。
💡 小技巧：同一查询中三个符号可自由混搭。比如
^.*.-表示"最新大版本 + 任意次版本 + 最旧修订号"。
三、用 Build Hash 精准定位任意构建
每个构建在列表中都对应一个唯一的 Git 哈希（Build Hash）。单击日期/时间列即可切换显示哈希值，把哈希复制后按+哈希格式填入搜索栏：
*.*.*+cb886aba06d5这样就能跨所有版本、所有分支，唯一定位那一个构建。适用场景：
- 同事说"我用的那个构建出问题了"，拿到哈希立刻复现
- 排查某个具体构建的回归 Bug
注意：Build Hash 只支持精确匹配，不能用^或-这类符号。
四、组合技：分支名 + 提交时间
按分支过滤
版本号后加-分支名（区分大小写，与列表中的 Branch 列一致）：
*.*.*-stable # 只看 Stable 构建 *.*.*-daily # 只看 Daily 构建 4.3.^-stable # 4.3 最新修订号的 stable 构建还支持逗号分隔的多分支：*.*.*-stable,daily同时匹配两个分支。
按提交时间过滤
版本号后加@时间，支持 ISO 格式时间戳，也支持符号：
4.3.^@2024-07-31T23:53:51+00:00 # 指定时刻的构建 4.3.^-stable@^ # stable 分支中该版本最新提交的构建一条"满配"查询长这样
4.3.^-stable+cb886aba06d5@2024-07-31T23:53:51+00:00含义：4.3 最新修订号、stable 分支、指定哈希、指定提交时间——把搜索范围收敛到唯一构建。
五、模糊搜索：空格后面写关键词，拼错也能找到
在版本查询后加一个空格，再跟任意文字，就会触发模糊文本搜索：
4.3.* Sculpt # 4.3 里分支/文件夹名含 Sculpt 的构建 *.*.* Geometry Nodes # 全局找 Geometry Nodes 相关构建更妙的是，即使整段文本解析不出版本号，也会自动退化为模糊搜索。而且它自带容错——允许最多 1 次删除、1 次替换、1 次插入的拼写偏差（例如Gemoetry Nods也能命中），所以手速打快也不怕。
模糊搜索会匹配版本、分支名、自定义名称、哈希、提交时间和文件夹名。
六、双保险：勾选日期范围缩小范围
搜索栏下方还有两个复选框（见 source/widgets/search_bar/search_bar.py 实现）：
- ☑️after+ 日期：只看该日期之后的构建
- ☑️before+ 日期：只看该日期之前的构建
两者可与语法查询叠加，特别适合"找某次事故前后那一天的构建"这类场景。
七、常用搜索语句速查表
| 你的需求 | 搜索语句 |
|---|---|
| 浏览所有构建 | *.*.* |
| 当前最新大版本全家桶 | ^.*.* |
| 4.3 系列的稳定版 | 4.3.*-stable |
| 某大版本内最新次版本的 stable | 4.^.*-stable |
| 按哈希精确找构建 | *.*.*+cb886aba06d5 |
| 最新构建（任何分支） | ^.*.^ |
| 4.3 stable 最新构建（含哈希+时间） | 4.3.^-stable+cb886aba06d5@^ |
| 4.3 里带 Sculpt 字样的构建 | 4.3.* Sculpt |
| 最早大版本的稳定版（考古用） | -*.*-stable |
八、写在最后
记住一个心法：^追新、*通配、-考古、+锁哈希。掌握这四个符号加上分支名和提交时间，Blender Launcher V2 的几百个构建对你来说就像带索引的数据库。更多界面与操作细节，可参考官方文档的 docs/docs/user_interface.md；完整的语法规则与正则定义则沉淀在 source/modules/version_matcher.py 中，欢迎深入源码一探究竟。
【免费下载链接】Blender-Launcher-V2Standalone client for managing official builds of Blender 3D and its popular forks项目地址: https://gitcode.com/gh_mirrors/bl/Blender-Launcher-V2
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
