如何用git worktree管理不同分支的git忽略node_modules目录？

Git Worktree确实是解决这个问题的正确方案，你的核心问题是用法理解偏差——它的设计目标是为每个分支创建独立的完整工作目录，而非直接将node_modules作为worktree目录。下面是正确的操作步骤：

一、清理错误的worktree配置（可选） #

如果你之前创建过无效的worktree，先执行以下命令清理：

git worktree prune
# 手动删除之前创建的node_modules_foo、node_modules_bar等目录
rm -rf node_modules_foo node_modules_bar

二、为每个分支创建独立工作目录 #

假设你的原仓库目录为my-project，现有两个分支main和feature-branch：

1. 进入原仓库目录，确保当前在其中一个分支（比如main）：

   cd my-project
   git checkout main
   

2. 为另一个分支创建独立的工作目录（建议放在原仓库同级目录，避免干扰）：

   git worktree add ../my-project-feature feature-branch
   

   执行后会在原仓库的上级目录生成my-project-feature文件夹，里面是feature-branch的完整代码文件。

三、分别安装分支依赖 #

• 在原仓库目录my-project下执行：

  npm install
  

  安装main分支的依赖，生成该分支专属的node_modules。
• 在新创建的工作目录my-project-feature下执行：

  cd ../my-project-feature
  npm install
  

  安装feature-branch分支的依赖，生成独立的node_modules。

四、日常使用方式 #

• 不需要在原目录切换分支，直接进入对应工作目录即可操作：
  • 要操作main分支，进入my-project；
  • 要操作feature-branch分支，进入my-project-feature。
• 两个目录的代码修改、提交都会同步到原Git仓库的对应分支，所有提交记录完整保留。

为什么你之前的用法错误？ #

1. 重复检出分支报错：Git不允许同一个分支被检出到多个worktree，所以你执行git worktree add ./node_modules <current_branch_name>会报错，因为该分支已经在原目录被检出。
2. 错误指定worktree目录：你试图将node_modules作为worktree目录，但worktree需要托管完整的分支代码（包括package.json、源码等），而非单独的依赖目录，这导致依赖无法和对应分支绑定。

替代方案（无需Worktree） #

如果你不想使用Git Worktree，可以写一个简单的脚本简化切换流程：

#!/bin/bash
# 保存为switch-branch.sh
git checkout "$1" && rm -rf node_modules && npm ci

赋予脚本执行权限：

chmod +x switch-branch.sh

使用方式：

# 切换到feature-branch并自动安装依赖
./switch-branch.sh feature-branch

npm ci比npm install更快，会严格按照package-lock.json安装依赖，避免版本不一致问题。

内容的提问来源于stack exchange，提问作者learntheropes