git worktree add 更适合多环境并行，因为它为每个分支创建独立物理目录，共享同一 .git 数据库但互不干扰，支持各 worktree 独立运行服务、保留未提交代码和调试状态，避免 git checkout 的切换冲突与重复构建。
git worktree add 为什么比 git checkout 更适合多环境并行
因为 git checkout 只能在一个工作目录里操作，每次切换分支都得清理未提交变更、重装依赖、重启服务；而 git worktree add 是真正意义上的“开新窗口”——它为每个分支创建独立的物理目录，共享同一份 .git 数据库，但互不干扰。
常见错误现象：用 git checkout 切到 hotfix/payment 后，IDEA 报错 .idea/workspace.xml would be overwritten，或者前端 yarn dev 重新编译卡住。这不是 Git 故障，是你在用单线程方式跑多任务。
- 每个
worktree目录可独立运行npm start、docker-compose up、python manage.py runserver，进程不会互相 kill - 不用
git stash或WIP提交，未保存代码、断点、日志 tail 都原地保留 - 删除某个 worktree（如
git worktree remove ../feature-login）只删文件夹，不碰任何提交历史
如何避免 .idea/.vscode 文件在 worktree 间冲突
问题不在 Git，而在 IDE 自动生成配置时没区分上下文——所有 worktree 共享同一个 .gitignore，但每个目录都试图写自己的 .idea/。结果就是你在 ../dev 里改了运行配置，切到 ../test 时被覆盖。
正确做法不是删掉 .idea，而是让每个 worktree 拥有专属配置：
CNB 云原生构建平台的 Git 操作技能，支持代码克隆、提交、推送、分支管理、Merge Request 管理、流水线触发与结果读取。初次使用需收集用户的 Git 用户名和邮箱。
- 在每个 worktree 根目录下新建
.idea/，并确保.gitignore里有.idea/（不是**/.idea/），防止意外提交 - VS Code 用户可在每个 worktree 的
.vscode/settings.json中加"git.ignoreSubmodules": true，避免跨 worktree 的 Git 状态污染 - IntelliJ IDEA 需关闭 “Share project configuration files” 选项（Settings → Version Control → Shared Configuration），否则会把
.idea/workspace.xml当成共享配置同步
worktree + Docker 构建时怎么保证源码版本准确
Dockerfile 里的 COPY . . 默认复制当前目录全部内容，但如果当前目录是 worktree，它只包含该分支的文件快照——这正是你想要的，但容易忽略两点：
- 确保
Dockerfile和.dockerignore都放在 worktree 根目录，而不是主仓库根目录；否则构建可能误用主目录下的旧文件 - 如果使用多阶段构建（比如
FROM python:3.11-slim→COPY . .），注意.指向的是 worktree 路径，不是git rev-parse --show-toplevel返回的主仓库路径 - CI 中执行
docker build -f Dockerfile -t myapp:dev .时，务必确认当前工作目录是 worktree 目录，否则构建镜像会包含错误分支代码
git worktree prune 为什么不能随便跑
git worktree prune 会删掉所有“已不存在”的 worktree 记录，但它判断“不存在”的标准只是检查目录是否还存在——如果某个 worktree 目录被临时移到别处备份，或挂载在 NFS 上偶发不可达，prune 就会把它从 git worktree list 里清掉，导致后续 git worktree remove 失败、甚至无法再用 git branch -D 删除对应分支（Git 会报 branch is checked out in worktree）。
真正安全的做法是手动清理：
- 先
git worktree list确认哪些 worktree 还在磁盘上 - 对已删除的 worktree，用
git worktree remove /path/to/missing显式移除记录（即使目录不存在，Git 也允许） - 最后才跑
git worktree prune --expire=0强制清理残留，而非默认的 3 天过期策略
worktree 的核心价值不在“多开几个目录”，而在把“代码状态”和“运行时态”解耦——你很容易忘记，那个开着 tail -f 的终端、正在 debug 的断点、甚至数据库连接池里的空闲连接，都是某个 worktree 独有的上下文，删目录前最好先 ps aux | grep -E "(node|python|java)" 看一眼。
