使用 `git worktree` 管理多个工作目录,比 `git stash` 更高级的分支管理方式

简介

git worktree 是 Git 提供的一个子命令,允许在一个仓库中创建多个额外的工作目录(工作树),每个目录可关联一个独立的分支,从而实现多个分支的并行开发,无需频繁切换分支或使用 git stash 暂存。


常见用途

用途 命令
添加一个工作目录用于新分支 git worktree add ../feature-dir feature-branch
列出当前所有 worktree git worktree list
删除 worktree(不会删除分支) git worktree remove ../feature-dir

示例:并行开发多个分支

bash 复制代码
# 进入项目目录
cd my-project

# 为 feature/login 创建一个工作目录
git worktree add ../my-project-login feature/login

# 为 bugfix/crash 创建另一个工作目录
git worktree add ../my-project-crash bugfix/crash

此后你可在使用命令行/IDE在两个目录中分别独立开发、提交,互不干扰。


git stash 对比

功能/特性 git stash git worktree
作用 暂存当前更改,快速切分支 管理多个工作目录并行开发多个分支
多分支并行开发支持 否,仅能切换一个分支 是,每个工作目录一个分支
文件状态保存方式 储存在 stash 栈中 实际存在于多个工作目录
推荐使用场景 快速临时切换分支,不希望提交当前更改 长期并行开发多个特性/修复任务

与复制项目文件夹的对比

功能/特性 git worktree 复制文件夹(cp -r
Git 支持 原生支持,多个工作目录共享 .git 数据 每个目录都是独立 Git 仓库副本,彼此无关
空间占用 小,.git 数据不重复,源码为主 大,.git 和代码文件全部复制
分支独立性 高,每个目录可以检出独立分支 分支也可独立,但管理多个仓库代价更高
恢复安全性 强,误删工作目录后可从主仓库恢复 弱,误删后无直接恢复方式(需备份)
推荐用途 推荐用于 Git 管理内的并行协作开发 推荐用于导出/迁移到其他非 Git 管理环境或测试

存储空间大小说明

使用 git worktree 创建的目录非常轻量,结构如下:

  • 新目录中 .git 实际是一个指向主仓库 .git/worktrees/xxx 的文件;
  • 所有 Git 对象(如提交历史、快照)依旧存储在主仓库中;
  • 每个工作目录仅包含源码文件,没有重复的 Git 对象副本。

查看大小示例:

bash 复制代码
# 查看主仓库的 Git 数据大小
du -sh .git

# 查看 worktree 的目录大小(一般仅为代码文件大小)
du -sh ../my-project-login

对比复制项目文件夹,git worktree 占用空间更小、效率更高。


误删 worktree 目录后的恢复方法

如果误删了某个 worktree 目录,例如:

bash 复制代码
rm -rf ../my-project-login

执行 git worktree list 会看到如下异常:

bash 复制代码
/path/to/my-project        [main]
../my-project-login        (error)

恢复流程:

  1. 清理 Git 内部的无效记录

    复制代码
    git worktree prune

    这将移除 .git/worktrees/ 下失效的引用,清理异常状态。

  2. 重新添加工作目录

    若对应分支仍存在:

    bash 复制代码
    git worktree add ../my-project-login feature/login

    即可重新创建并恢复该目录。


使用建议

删除工作目录前,请始终使用 git worktree remove <dir>,确保主仓库中不残留失效引用,避免后续 Git 报错。

相关推荐
李boyang9 天前
Git(四):远程操作
git
荻野泽溪9 天前
Git新建分支并同步到远程
git
漫步企鹅9 天前
【Git】新建一个远程分支的常规操作
git·新建远程分支
潇-xiao10 天前
Linux下的版本控制器Git(15)
linux·笔记·git
@昵称不存在10 天前
Git学习
git·学习
pe7er10 天前
⛔️⛔️⛔️丢弃本地commit,强制采用远端代码
git
浮梦终焉10 天前
CLion开发Qt桌面程序_git的简单使用_小团体
c++·git·qt·桌面应用·clion
至此流年莫相忘10 天前
Git集成Jenkins通过Pipeline方式实现一键部署
运维·git·jenkins
科文小白狼11 天前
Git使用总结
git