用 direnv 按目录自动加载环境变量

为什么需要它

同时维护多个项目时，每个项目的环境变量都不一样（数据库地址、API 端点、调试开关）。手动 export 容易忘，写进 shell 配置文件又会互相污染。direnv 能在进入目录时自动加载变量，离开时自动卸载。

安装与接入

用系统包管理器安装（如 apt install direnv 或 brew install direnv），然后在 shell 配置里加入钩子，例如 bash：

eval "$(direnv hook bash)"

基本用法

在项目根目录新建 .envrc：

export APP_ENV=dev
export API_BASE=http://localhost:8080

首次使用要执行 direnv allow 授权。之后 cd 进目录变量就会生效，离开即恢复。.envrc 被修改后需要重新 allow，防止被悄悄篡改。

实用技巧

• 用 dotenv 指令读取已有的 .env 文件。
• 配合 layout python 自动启用项目虚拟环境。
• 把含密钥的 .envrc 加入 .gitignore，另提交一份 .envrc.example 作模板。

小结

direnv 把“这个项目需要什么环境”固化在目录里，切换项目零负担，也减少了把测试配置误用到生产的风险。