语法
- 最简单的写法:
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>