git worktree 不支持分支级环境变量隔离，需通过在各 worktree 根目录放置 .env.local 并显式加载（如 dotenv -e .env.local）或 shell source 方式实现路径感知的按需注入。
Git worktree 本身不支持分支级环境变量隔离，必须靠外部机制实现。它只管文件检出和 Git 对象共享，.env、.env.local 这类文件是否生效，完全取决于你启动服务时用的工具（如 dotenv 库）是否读取了当前目录下的对应文件——而这个“当前目录”正是 worktree 所在路径。
为什么 .env 文件在 worktree 里没自动生效？
常见错误现象是：你在 worktree-a 里改了 .env.local，启动服务后发现还是读到了主仓库根目录或另一个 worktree 的变量。原因有三：
-
dotenv类库默认只查当前进程工作目录（即pwd），但很多脚本（比如npm run dev）会把工作目录设为项目根，而非你 cd 进去的那个 worktree 目录 - IDE（如 VS Code）启动终端时可能继承父窗口的环境，不会重新加载当前文件夹下的
.env - 某些语言运行时（如 Java 的 Spring Boot）会按固定顺序查找
.env，不认子目录里的同名文件
worktree 下安全注入分支专属环境变量的实操方式
核心原则：让环境变量加载逻辑与 worktree 路径强绑定，不依赖全局或项目根位置。
- 在每个 worktree 根目录下放一个
.env.local，内容只写该分支需要覆盖的变量，例如：NODE_ENV=development、API_BASE_URL=https://staging.example.com - 启动命令显式指定 dotenv 路径，例如：
node -r dotenv/config index.js dotenv_config_path=.env.local - 对 npm script 做分支感知封装：在
package.json中加一条"dev:branch": "dotenv -e .env.local -- node index.js"，确保每次都在当前目录找.env.local - Shell 层面可加简单防护：在 worktree 目录下放一个
.env.sh，内容为export API_BASE_URL=https://staging.example.com；然后在启动前执行source .env.sh—— 这比依赖 dotenv 更轻量、更可控
Git hooks + worktree 自动化注入的坑点
有人想用 post-checkout hook 自动复制 .env.local，但 worktree 没有 checkout 触发点——git worktree add 不走标准 hook 流程。真正可用的是：
-
post-worktree-add：Git 2.35+ 支持的自定义 hook（需手动创建.git/hooks/post-worktree-add），但它只在add时触发一次，无法响应后续分支切换 - 更可靠的做法是：把环境变量注入逻辑下沉到启动脚本中，例如
./scripts/start-dev.sh开头就检查是否存在.env.local，存在则set -a; source .env.local; set +a - 切记不要在
.bashrc或~/.zshrc里硬编码路径，否则所有终端都会污染；worktree 环境必须是“按需加载、按目录隔离”的
真正容易被忽略的是：环境变量不是 Git 的一等公民，它不随分支自动流转。你必须在服务启动链路的最前端（shell 层或 runtime 层）做路径感知加载，任何试图靠 Git 配置或全局 hook 统一管理的方案，都会在多 worktree 场景下失效。
