macos 安装 worktrunk 可以使用 homebrew,也可以从 github releases 下载对应架构的二进制。安装后先核对 wt 和 git 版本,再启用 zsh 集成,让 wt switch 能改变当前终端目录。
先确认 macOS 架构和 Git 版本
打开终端执行下面几条命令,输出 arm64 就说明你用的是 Apple Silicon 芯片。我们实测的 wt v0.81.0 要求 Git 版本不低于 2.43.0,如果查出来还是系统自带的旧版 Apple Git,先升级 Git 或者调整 PATH 优先级。
uname -m git --version command -v git

用 Homebrew 或发行包安装
要是你已经配置好 Homebrew,直接跑命令就能安装 Worktrunk。安装完成后用 command -v wt 核对路径,确保当前终端能找到对应的可执行文件。
brew install worktrunk command -v wt wt --version
Apple Silicon 也可以解压官方二进制
到 GitHub Releases 页面选 macOS ARM64 归档包,以下载得到的文件名 worktrunk-aarch64-apple-darwin.tar.xz 为例,切到下载目录解压,再把可执行文件放到自己的用户可执行目录里。
tar xf worktrunk-aarch64-apple-darwin.tar.xz mkdir -p "$HOME/.local/bin" install -m 755 worktrunk-aarch64-apple-darwin/wt "$HOME/.local/bin/wt" export PATH="$HOME/.local/bin:$PATH" wt --version
下载时选文件名包含 aarch64-apple-darwin 的归档即可,同名的 .sha256 文件用来校验下载内容的完整性。

怎么让 wt switch 自动进入工作树?
给 zsh 装好 shell 集成之后,重启终端就生效了。执行 type wt,输出结果会显示它是一个 shell 函数。不想重启终端的话,也可以直接在当前会话跑 eval "$(wt config shell init zsh)" 实现临时生效。
wt config shell install zsh exec zsh
新开的终端会话里,依次执行 type wt、wt --version 和 git --version 做校验。如果命令只识别到普通二进制,就检查 zsh 启动配置文件有没有加载初始化脚本,同时确认 PATH 变量的优先级设置是否正确。


















