Git Worktree详解介绍

在日常开发中,我们经常遇到这样的场景:

  • 当前分支正在开发功能 A,但突然要修紧急 bug
  • 需要同时对比两个分支的代码
  • 想在不切换当前工作目录的情况下并行开发
  • build / test 需要在不同分支同时进行

第一想法就是git stash + git checkout 来回切分支,或者clone 一个目录,但 Git 早就提供了一个更优雅的能力:git worktree

一、Git Worktree 是什么?

Git Worktree 是 Git 提供的一种能力:允许一个 Git 仓库(.git)关联多个工作目录(working tree)。

复制代码
project-main/        (main branch)
project-feature/     (feature branch)
project-hotfix/      (hotfix branch)

它们:

  • 共享同一个 .git
  • 但每个目录可以 checkout 不同分支
  • 互不影响

二、核心价值

1. 不再频繁 stash / checkout

避免:

  • git stash
  • git checkout
  • git stash pop

worktree方式:

shell 复制代码
git worktree add ../hotfix hotfix

2. 并行开发

多个 IDE 同时打开不同分支:

  • IntelliJ:feature 分支
  • VSCode:hotfix 分支
  • Terminal:release 分支

互不干扰。


3. 避免重复 clone

不用多次 git clone,一个仓库即可。


4. CI/CD 友好

例如:

  • 一个目录跑 build
  • 一个目录跑 test
  • 一个目录跑 benchmark

避免 checkout 互相污染。


三、原理

  • .git 是唯一的
  • worktree 是多个工作目录
  • Git 通过 gitdir 关联
shell 复制代码
repo/
  .git (主仓库)

../feature/
  .git -> repo/.git/worktrees/feature

四、常用命令

1. 查看

shell 复制代码
git worktree list

2. 创建

shell 复制代码
git worktree add <path> <branch>

# 1、在 ../feature 创建工作目录
# 2、checkout feature 分支
git worktree add ../feature feature

3. 创建新分支

shell 复制代码
git worktree add -b new-feature ../new-feature main

#1、从 main 创建新分支 new-feature
#2、在新目录 checkout 

4. 删除

shell 复制代码
git worktree remove <path>

#1、目录必须没有未提交修改
#2、否则需要 --force

5. 清理

shell 复制代码
#用于清理 Git 内部残留记录。
git worktree prune

6. 锁定

shell 复制代码
# 锁定
git worktree lock <path>
# 解锁
git worktree unlock ../feature

五、应用场景

1. 紧急修 bug

feature 开发中 → hotfix 并行处理

传统方式:

  • stash
  • 切分支
  • 修 bug
  • 再切回来

worktree:

shell 复制代码
git worktree add ../hotfix hotfix

2. 多版本维护

v1 / v2 / v3 并行维护

shell 复制代码
git worktree add ../v1 v1.0
git worktree add ../v2 v2.0
git worktree add ../v3 v3.0

3. 多环境对比

不同分支同时运行对比行为

shell 复制代码
git worktree add ../main main
git worktree add ../feature feature

4. CI 构建

避免重复 clone,加速构建


六、注意事项

  • 同一分支不能同时 checkout 多个 worktree
  • 删除必须 git worktree remove
  • 不要直接 rm -rf
  • worktree 不是独立仓库
相关推荐
武昌库里写JAVA12 小时前
SpringBoot+Vue 项目介绍
java·javascript·git·sql·ai
Hvitur3 天前
Git - 多分支合并
git·github
考虑考虑3 天前
git刷新远程分支列表
git·后端·gitlab
AI大模型-小华3 天前
Codex 自动测试怎么用?从生成测试用例到修复失败用例
git·测试用例·ai编程·软件开发·codex·chatgpt pro·codex cli
七分辣度4 天前
GitHub/Git 常用命令及使用场景
git·github
慧都小项5 天前
MyEclipse Inline Diff 实用指南:逐处核对 AI 修改再提交
git·ai编程·myeclipse·java 代码审查·ai 代码修改
德育处主任5 天前
让 Claude Code 在你睡觉时接着干活:tmux、权限策略与验收清单
git·ai编程·命令行
为思念酝酿的痛7 天前
Git基本操作
git·github
wno7048 天前
常用的Git命令清单
大数据·git·elasticsearch
真上帝的左手9 天前
3. 代码管理-Git-进阶
git·源代码管理