git worktree

文章目录[隐藏]

• 相关命令

语法

• 最简单的写法： git worktree add <新路径> 将基于当前分支，新建一个 worktree 目录，新的分支名就是新建目录的名称。
• 新建一个指定分支 git worktree add <新路径> -b <新分支名> 将基于当前分支，新建一个 worktree 目录，新的分支名是指定的名称。
• 基于指定分支新建一个指定分支 git worktree add <新路径> -b <新分支名> <指定分支名> 将基于指定分支，新建一个 worktree 目录，新的分支名是指定的名称。

示例

# 基于当前分支当前目录的父目录新建一个文件夹，新建分支admin-bug1
git worktree add ../admin-bug1 -b admin-bug1 

注意

• <新路径> 新路径一般是类似 ../myproject-bugfix 这样的命名，是相对路径，注意，这里一定是两个点： ../myproject-bugfix 表示在当前目录的父目录新建，这样才是与原工程目录平级。（当前，你当前得在原工程的跟目录中。） 总之，注意相对路径。
• 使用 git reset –hard 重置新的 worktree 如果使用了 git worktree add <新路径> 最简单的方法新建，通常分支需要重新命名，基于的分支也要改。 可使用 git reset --hard <要基于的分支名> 重置到想要的分支，使用 git branch -D <想要删除的分支名> 删除自动创建的与目录名相同的分支。
• 不使用的 worktree 尽早删除，并运行 git worktree prune 清理
• worktree 不允许两个 worktree 使用同一个分支

相关命令

# 添加worktree 
git worktree add [-f] [--checkout -b <new-branch>] <path> <commit-ish>

# 列出所有worktree 
git worktree list [--porcelain]

# worktree上锁 
git worktree lock [--reason <string> <worktree>]

# worktree解锁 
git worktree unlock <worktree>

# 移动worktree到其他目录 
git worktree move <worktree> <new-path>

# 删除worktree, 同时删除检出目录 
git worktree remove -f <worktree>

# 清除那些检出目录已经被删除的worktree 
git worktree prune -n --expire <expire>