Git 工作树允许在一个仓库中同时维护多个独立的工作目录，每个目录对应不同分支，避免频繁切换分支导致的上下文干扰。介绍核心原理、基础命令（add/list/remove）、实战案例及常见问题解决方案。适用于 Git 2.5+ 版本，需注意路径冲突和版本兼容性。
想象一下，你正在用电脑同时处理多个任务。Git 的工作树就像'多开窗口'，它让你可以在一个 Git 仓库中同时处理多个分支，而不需要来回切换。
重点：工作树是 Git 的'多开窗口'，它允许你在一个仓库中同时拥有多个工作目录，每个工作目录对应一个不同的分支。
使用工作树的优势包括：
Git 工作树的工作原理类似'多开窗口'：
Main Repository (主仓库)
├── Working Tree 1 (分支 A)
├── Working Tree 2 (分支 B)
└── Working Tree 3 (分支 C)
关键点：
小贴士：在本地 Git 客户端中使用
git worktree命令。
# 1. 创建主项目
mkdir git-worktree-demo && cd git-worktree-demo
git init
echo "# Git Worktree Demo" > README.md
git add README.md
git commit -m "Initial commit"
# 2. 创建第一个工作树（主分支）
git worktree add ../worktree-main main
💡 重要提示：
git worktree add命令会创建一个新的工作目录，指向指定的分支。
# 1. 创建功能分支
git branch feature-1
# 2. 创建工作树
git worktree add ../worktree-feature-1 feature-1
# 1. 创建修复分支
git branch fix-bug
# 2. 创建工作树
git worktree add ../worktree-fix fix-bug
# 进入主分支工作树
cd ../worktree-main
# 修改文件
echo "Main branch update" >> README.md
git add README.md
git commit -m "Update main branch"
# 回到主仓库目录
cd ../git-worktree-demo
# 查看所有工作树
git worktree list
# 删除工作树
git worktree remove ../worktree-fix
💡 重要提示：
git worktree list显示所有工作树的路径、分支和状态。
# 1. 创建主仓库
mkdir worktree-demo && cd worktree-demo
git init
echo "# Worktree Demo" > README.md
git add README.md
git commit -m "Initial commit"
# 2. 创建主分支工作树
git worktree add ../main-worktree main
# 3. 创建功能分支
git branch feature-1
git worktree add ../feature-1 feature-1
# 4. 创建另一个功能分支
git branch feature-2
git worktree add ../feature-2 feature-2
# 5. 在不同工作树中工作
cd ../main-worktree
echo "Main branch update" >> README.md
git add README.md
git commit -m "Update main"
cd ../feature-1
echo "Feature 1 implementation" >> README.md
git add README.md
git commit -m "Add feature 1"
cd ../feature-2
echo "Feature 2 implementation" >> README.md
git add README.md
git commit -m "Add feature 2"
# 6. 回到主仓库
cd ../worktree-demo
git worktree 命令不可用原因：Git 版本过低（需要 Git 2.5+）。
解决：
# 检查 Git 版本
git --version
# 如果版本过低，升级 Git
# Ubuntu: sudo apt-get install git
# macOS: brew install git
原因：工作树路径与现有目录重叠。
解决：
/home/user/worktrees/main-worktree）原因：工作树是独立的，修改不会自动同步到主仓库。
解决：
git pull 获取更新git push 推送更改原因：工作树中的 .gitignore 文件与主仓库不同。
解决：
.gitignore 文件与主仓库一致.gitignore# 创建别名
git config --global alias.wt 'worktree'
# 使用别名
git wt add ../feature-3 feature-3
# 查看所有工作树的详细信息
git worktree list --verbose
# 进入工作树目录
cd ../worktree-feature-1
# 设置工作树特定配置
git config user.name "Feature 1 Developer"
git config user.email "[email protected]"
# 回到主仓库
cd ../worktree-demo
| 项目 | 说明 |
|---|---|
| 工作树是什么 | Git 的'多开窗口'，允许一个仓库同时有多个工作目录 |
| 关键命令 | git worktree add、git worktree list、git worktree remove |
| 最佳实践 | 1. 为每个工作树使用有意义的路径 2. 确保 Git 版本是 2.5+ 3. 在工作树中提交后，记得同步到主仓库 |
| 常见问题 | 1. 旧版 Git 不支持工作树 2. 工作树路径冲突 3. 工作树中的修改不会自动同步 |
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online