direnv

按目录自动加载/卸载环境变量

补充说明

direnv 在进入目录时加载 .envrc，离开时卸载。它适合为不同项目设置 PATH、API endpoint、虚拟环境等，避免污染全局 shell。

常用示例

# ~/.bashrc / ~/.zshrc
eval "$(direnv hook bash)"
eval "$(direnv hook zsh)"

# 项目根目录
echo 'export APP_ENV=dev' > .envrc
direnv allow

# .envrc
layout python
use node 20
dotenv

易错点与排错

• 新写的 .envrc 默认被拒绝；必须 direnv allow，这是安全设计。
• .envrc 是可执行 shell；不要从不可信仓库直接 allow。
• 离开目录才会卸载；在子 shell/IDE 里可能不会触发 hook。
• dotenv 会加载 .env，但变量覆盖顺序要确认。
• 敏感值不要提交到仓库；.envrc 可提交，.env 通常忽略。
• 与 tmux/screen/IDE 终端集成时，确认 hook 已加载。
• 调试用 direnv status、direnv reload，不要直接改内部缓存。