Worktrunk：并行工作树、生命周期控制与源码分析
安装 Worktrunk：拆开二进制、终端集成和项目配置
按 macOS、Linux 与 Windows 区分安装方式，记录实际版本，并为终端设置和团队推广准备明确的回退路径。
你将学会
- 这里的部署是接入本地开发工具
- 终端集成是另一项独立配置变更
- 个人默认值和共享项目行为分别管理
开始前需要
- 基础 Git 分支和命令行导航知识
- 可用于选做练习的一次性仓库
解释工作树边界，核对首次检出结果，并在采用自动化前审阅配置命令。
先看结论
- 安装包、终端集成和项目配置是三层工作。
- Windows 上需要区分 wt、git-wt 与 git wt。
- 记录实际安装版本，不假设它等于检查过的提交。
这里的部署是接入本地开发工具
Worktrunk 不是天然需要数据库、容器或公网端口的 Web 服务。固定版本 README 提供 Homebrew、Cargo 和 Windows Winget 安装路线。这些命令负责获取软件，但包仓库现在提供的版本未必就是本文检查的提交。安装后应记录实际版本，并查看与本系列涉及行为有关的变更。
如果选择从固定提交构建，Cargo.toml 声明的前置条件是 Rust 1.97 和 2024 edition。这是源码编译要求，不代表每位预编译包用户都必须安装编译器。本文没有安装系统包、编译 Rust，也没有修改用户终端配置，因此不能把文档路线说成我们的实机部署结果。
终端集成是另一项独立配置变更
README 在安装后使用 wt config shell install，Windows 则使用 git-wt config shell install。这一步会修改终端配置，应先备份并审阅具体变更。二进制可以从 PATH 找到，并不等于当前终端已经加载包装函数；需要在新终端中，用一次性仓库验证目录导航。
Windows 有两层容易混淆的命名：wt 已被 Windows Terminal 使用，而 git wt 与直接调用 git-wt 在父终端导航上也不等价。遇到问题先检查命令实际解析到哪里，不要立即重装。保留原配置和本次添加的集成项，回退时仅撤销这项变更，不删除整份个人配置。
个人默认值和共享项目行为分别管理
文档中的用户配置路径在 macOS/Linux 上是 ~/.config/worktrunk/config.toml，并受 XDG 配置影响；Windows 使用 %APPDATA% 下的 worktrunk/config.toml。项目配置位于可提交的 .config/wt.toml。系统默认值和覆盖项也可能参与，因此应在实际环境中检查 wt config show，而不是认为某一个文件解释了全部行为。
团队推广先选一个试用配置和一个一次性项目，记录包版本、命令路径、配置位置、包装函数状态和上手结果。批准记录应与可携带的项目配置分离。升级前重点审阅钩子、合并默认值和批准机制的变化；回退应恢复原包与精确集成项，同时保留不属于本次推广的用户设置。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
选择平台文档中的路线，并审阅影响范围。
- 2
记录实际版本与命令解析路径。
- 3
备份并检查终端集成变更。
- 4
通过一次性仓库验收后再共享项目钩子。
可复制示例
安装审阅记录
安装包版本：待检查
实际命令：记录完整路径
终端集成：已安装 / 已生效 / 被绕过
用户配置：记录实际位置
项目配置：审阅 .config/wt.toml
回退：原安装包和精确的终端配置项常见问题
必须使用 Docker 吗？
不需要。本系列分析的是本地命令行工具，没有虚构服务端部署方案。
使用预编译包也必须安装 Rust 1.97 吗？
清单中的版本要求针对固定源码的编译；平台安装包应按自己的前置条件检查。
资料来源
- Worktrunk / README.md来源核查 2026-09-14
- Worktrunk / Cargo.toml来源核查 2026-09-14
- Worktrunk / docs/src/content/docs/config.md来源核查 2026-09-14
- Worktrunk / src/output/shell_integration.rs来源核查 2026-09-14