direnv的使用

# Debian/Ubuntu
sudo apt update && sudo apt install direnv

# CentOS/RHEL
sudo dnf install direnv

或者直接下载github上的二进制文件。

在 ~/.bashrc 或 ~/.zshrc 末尾添加：

# Bash
eval "$(direnv hook bash)"

# Zsh
eval "$(direnv hook zsh)"
重载配置：source ~/.bashrc 或 source ~/.zshrc

进入你的项目目录，创建 .envrc 文件：

# 方式一：标准 venv 激活（推荐）
export VIRTUAL_ENV="$(pwd)/.venv"
export PATH="$VIRTUAL_ENV/bin:$PATH"

# 方式二：若使用 pyenv，可直接用内置指令
# use python
💡 注意：.envrc 默认不会自动执行，首次进入目录需手动授权：

注意需要在项目目录下执行 direnv allow
授权后，后续 cd 进入该目录会自动激活环境；cd 离开时会自动 deactivate。

.envrc 建议提交到 Git，但敏感配置可放 .envrc.local（已加入 .gitignore）

首次 allow 会记录到 ~/.local/share/direnv/whitelist，符合安全审计要求
可在 .envrc 中加入校验逻辑，例如：
if [[ ! -d ".venv" ]]; then
  echo "❌ 虚拟环境不存在，请先运行: python -m venv .venv && source .venv/bin/activate && pip install -r requirements.txt"
  exit 1
fi

1 优先 direnv：安全、可审计、支持多语言，符合 DevOps 规范。
2 避免硬编码路径：始终使用 $(pwd) 或相对路径，确保环境可移植。
3 CI/CD 兼容：direnv 仅对交互式 Shell 生效。在 Dockerfile 或 CI 脚本中，仍需显式 source .venv/bin/activate。
4 结合 Python 标准工作流：
	python -m venv .venv
	source .venv/bin/activate
	pip install -r requirements.txt
	direnv allow
5 监控与日志：若团队规模较大，可配合 direnv 的 --json 模式或自定义 Hook 记录环境切换行为，便于故障排查。