Git 工作树：多分支并行开发管理技巧

步骤 5：查看工作树

# 查看所有工作树
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

常见问题与解决

问题 1：git worktree 命令不可用

原因：Git 版本过低（需要 Git 2.5+）。

解决：

# 检查 Git 版本
git --version
# 如果版本过低，升级 Git
# Ubuntu: sudo apt-get install git
# macOS: brew install git

问题 2：工作树路径与现有目录冲突

原因：工作树路径与现有目录重叠。

解决：

1. 确保工作树路径是有效的、未被占用的目录
2. 使用绝对路径（如 /home/user/worktrees/main-worktree）
3. 或者使用不同的相对路径

问题 3：工作树中的修改无法同步

原因：工作树是独立的，修改不会自动同步到主仓库。

解决：

1. 在工作树中完成修改并提交
2. 切换回主仓库，使用 git pull 获取更新
3. 或者在工作树中使用 git push 推送更改

问题 4：工作树中的文件被忽略

原因：工作树中的 .gitignore 文件与主仓库不同。

解决：

1. 确保工作树中的 .gitignore 文件与主仓库一致
2. 或者在工作树中单独设置 .gitignore

高级用法

1. 为工作树设置别名

# 创建别名
git config --global alias.wt 'worktree'
# 使用别名
git wt add ../feature-3 feature-3

2. 查看所有工作树的详细信息

# 查看所有工作树的详细信息
git worktree list --verbose

3. 在工作树中设置不同的 Git 配置

# 进入工作树目录
cd ../worktree-feature-1
# 设置工作树特定配置
git config user.name "Feature 1 Developer"
git config user.email "[email protected]"
# 回到主仓库
cd ../worktree-demo

总结