使用git worktree时如何包含node_modules目录

直接用**符号链接（软链接）**就能实现需求，不用修改.gitignore、重新执行npm install或手动复制，具体步骤如下：

步骤1：创建工作树 #

先按常规命令创建目标分支的工作树，比如把feature-branch分支的工作树放到主仓库同级的my-feature-branch目录：

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

步骤2：创建指向主仓库node_modules的软链接 #

1. 进入新创建的工作树目录：

cd ../my-feature-branch

2. 如果工作树中自动生成了空的node_modules目录，先删除它：

rm -rf node_modules  # Linux/macOS环境
# Windows环境命令：rmdir /s /q node_modules

3. 创建软链接指向主仓库的node_modules（替换主仓库路径为你的实际路径，比如主仓库在../main-repo）：

# Linux/macOS环境
ln -s ../main-repo/node_modules node_modules

# Windows环境（需以管理员权限运行命令提示符）
mklink /D node_modules ..\main-repo\node_modules

验证使用 #

现在进入工作树目录，直接运行项目命令（比如npm run dev或npm run build），就能正常使用主仓库的依赖包了。

注意事项 #

• 确保主仓库的node_modules完整且版本正确，工作树会完全共享该目录的依赖，主仓库执行npm install/npm update更新依赖后，工作树会自动同步
• 符号链接不会被Git追踪，因为node_modules已在.gitignore中，无需额外配置
• 跨系统使用时注意符号链接的兼容性，Windows和Linux/macOS的创建命令不同，需对应执行

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