命令行玩转Blender Launcher V2:launch、update、register全部命令用法与实战示例
【免费下载链接】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 官方构建及其热门分支(forks)的独立客户端。除了图形界面,它还内置了一套完整的命令行接口:launch一行命令启动任意版本、update一键更新到新版本、register注册.blend文件关联。本文用 6 个实战场景带你快速掌握 Blender Launcher V2 命令行的全部用法。
💡 提示:所有命令都在终端中直接运行 Blender Launcher 可执行文件(下文简写为
BLV2)即可,无需打开图形界面。
🚀 为什么值得用命令行?
- 启动更快:跳过图形界面,几秒内拉起指定版本的 Blender
- 可脚本化:结合
--cli模式,可嵌入 CI/渲染农场等自动化流程 - 维护更彻底:更新、注册文件关联、彻底卸载都有对应命令,一处搞定
launch 命令完整用法:指定版本、打开文件、传递参数
launch是最高频的命令:启动指定版本的 Blender。其参数解析逻辑位于 source/main.py 与 source/modules/cli_launching.py。
核心参数一览
| 参数 | 说明 |
|---|---|
-f, --file FILE | 启动时打开指定的.blend文件 |
-ol, --open-last | 打开该构建最近一次的文件 |
-v, --version VERSION | 指定要启动的版本(查询语法见下文) |
-c, --cli | 纯命令行模式启动,不打开任何图形界面 |
--之后的内容 | 透传给 Blender 的额外参数 |
不指定任何参数时,launch会直接启动你设置的**快速启动(Quick Launch)**构建——日常最常用的就是它:
BLV2 launch版本查询语法:一行命令锁定目标构建
-v参数使用专门的查询语法(解析实现见 source/modules/version_matcher.py):
<major>.<minor>.<patch>[-branch][+build_hash][@commit_time]三个位置符号非常好用:^匹配最新、-匹配最旧、*通配任意值。
常用查询示例:
# 启动已下载构建中的最新版本 BLV2 launch -v "^.^.*" # 启动 4.3 分支(daily)最新的构建 BLV2 launch -v "4.3.^-daily@^" # 启动已下载的最旧构建 BLV2 launch -v "*.*.*@-" # 用构建哈希精确定位某个构建,并打开指定文件 BLV2 launch -v "4.2.0+a51f293548ad" -f "~/Blender/file.blend"当查询匹配到多个构建时,终端会列出编号清单,输入序号即可选择。所有示例都可追加-c以纯命令行模式运行(Linux 下体验最佳,Windows 打包版日志较乱)。
隐藏技巧:直接拖入 .blend 文件
如果你执行BLV2 /path/to/file.blend(不带launch),程序会自动识别文件并等价转换为launch -f file启动,这个逻辑同样在 source/main.py 中实现。
update 命令用法:一键更新到最新版本
无需去官网下载新安装包,一条命令即可自动下载并替换当前程序(实现位于 source/windows/update_window.py):
# 更新到最新版本 BLV2 update也可以指定目标版本号(release tag),例如回滚或尝鲜指定版本:
BLV2 update 2.7.6更新过程会显示下载与解压进度条,完成后程序会自动以新版本启动。
register 命令:注册 .blend 文件关联(仅 Windows)
register命令会把 Blender Launcher V2 写入 Windows 注册表,让.blend文件的"打开方式"菜单中出现它(实现位于 source/modules/shortcut.py):
# 注册 .blend 文件关联 BLV2 register # 撤销注册,还原系统设置 BLV2 unregister注册后,右键任意.blend文件即可选择通过 Launcher 打开,并自动进入版本选择流程,无需手动敲命令。
uninstall 命令:彻底卸载 Blender Launcher(仅 Windows)
uninstall会移除设置、注册表条目、快捷方式和缓存数据,实现干净卸载:
BLV2 uninstall # 免确认静默卸载(winget 卸载时使用) BLV2 uninstall --quiet全局命令行参数速查表
以下参数作用于整个程序入口(定义于 source/main.py):
| 参数 | 作用 |
|---|---|
-h, --help | 显示帮助信息并退出 |
-d, --debug | 启用 DEBUG 级别日志,排查问题必备 |
-set-library-folder PATH | 命令行方式设置构建库目录,免去图形界面操作 |
-force-first-time | 强制重新进入首次设置向导 |
--offline | 离线运行,禁用抓取线程与更新检查 |
--build-cache | 启动时缓存全部可用构建列表 |
--instanced | 跳过"是否已有实例在运行"检查 |
实战中常用的组合示例:
# 修改构建库目录后立即启动 BLV2 -set-library-folder "/data/blender/library" # 离线环境下以调试模式启动 BLV2 --offline -d # 渲染农场场景:纯 CLI 启动并透传 Blender 渲染参数 BLV2 launch -c -v "4.3.^-daily" -- --background -b scene.blend -o //render_ -f 1实战示例:6 个高频命令行场景
| 场景 | 命令 |
|---|---|
| 快速启动常用构建 | BLV2 launch |
| 启动 4.3 每日构建并打开指定文件 | BLV2 launch -v "4.3.^-daily@^" -f "scene.blend" |
| 继续上次的工作 | BLV2 launch -ol |
| 升级 Launcher 本身 | BLV2 update |
| 让 .blend 文件"打开方式"出现 Launcher(Windows) | BLV2 register |
| 彻底清理卸载(Windows) | BLV2 uninstall --quiet |
小结
Blender Launcher V2 的命令行能力覆盖了日常使用的全链路:launch负责启动任意版本构建并支持灵活的版本查询语法,update实现一键自更新,register/unregister管理.blend文件关联,uninstall提供彻底卸载。配合--offline、-d等全局参数和-c纯 CLI 模式,它同样能胜任脚本化与自动化场景。掌握以上 6 个实战场景,你就基本玩转了这套工具。 🎉
【免费下载链接】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),仅供参考