direnv是shell级环境变量管理工具，可自动加载/卸载项目专属变量（如VIRTUAL_ENV、PATH），配合Python虚拟环境实现自动激活：需先创建.venv，再在.envrc中用layout python3或source_env指定路径，并执行direnv allow授权。
direnv 是什么，它和 Python 虚拟环境怎么配合？
direnv 不是 Python 工具，而是一个 shell 级别的环境管理器——它在你 cd 进某个目录时自动加载/卸载环境变量（包括 PYTHONPATH、VIRTUAL_ENV、PATH 等），从而让 Python 项目“感知”到自己该用哪个解释器和依赖。关键点在于：它不替代 venv 或 poetry，而是把它们的激活逻辑自动化。
常见错误是以为装了 direnv 就能直接运行 python —— 实际上你仍需提前创建好虚拟环境（比如用 python -m venv .venv），然后让 direnv 帮你把它加进 PATH。
- 必须手动安装并 hook 到你的 shell（如
direnv allow后才能生效） - 它只对当前终端会话有效；新打开的终端需重新
cd才触发 - Python 相关变量不会自动继承父进程，所以别指望它“修复”已启动的 IDE 终端
如何写 .envrc 让 Python 项目自动切到本地 venv？
在项目根目录放一个 .envrc 文件，内容要明确指定虚拟环境路径，并更新 PATH 和 PYTHONHOME（避免系统 Python 干扰）。最简可靠写法如下：
layout python3 export PYTHONUNBUFFERED=1 export PYTHONIOENCODING=utf-8
其中 layout python3 是 direnv 内置指令，它会查找 .venv、venv、.pyenv 等常见目录并自动激活；如果你的虚拟环境叫 env 或放在子目录，就得手动写：
librosa 是一个用于音频和音乐分析的 Python 库。它提供了特征提取、频谱分析、节拍跟踪、起始检测和音频可视化的工具，基于 NumPy 和 SciPy 构建，用于科学音频计算。
立即学习“Python免费学习笔记（深入）”；
source_env ./my-env/bin/activate PATH_add ./my-env/bin
- 别用
source ./my-env/bin/activate—— 这会污染 shell 环境，direnv 要求用source_env -
PATH_add比直接赋值PATH=...更安全，避免覆盖原有路径 - 如果项目用
poetry，推荐用layout poetry（需先poetry install）
为什么 cd 进目录后 python 版本没变或 pip 仍装到全局？
这基本是权限或缓存问题：direnv 默认拒绝执行未授权的 .envrc，且 shell 可能缓存了 which python 结果。
- 首次进入目录时，终端会提示
direnv: error .envrc is blocked—— 必须手动运行direnv allow - 改过
.envrc后没生效？执行direnv reload或新开终端 - 检查是否真在用 venv 的 python：
which python应输出类似/path/to/project/.venv/bin/python，不是/usr/bin/python - 某些 zsh 插件（如 pyenv）会劫持
python命令，此时需在.envrc开头加unset PYENV_VERSION
多 Python 版本项目共存时要注意什么？
direnv 本身不管理 Python 版本，它只负责“暴露”已存在的环境。如果你要在不同项目中分别用 Python 3.9 和 3.11，得靠外部工具（如 pyenv）先准备好对应版本的 venv，再由 direnv 激活。
- 不要在
.envrc里调用pyenv local 3.9.18—— 这不会影响当前 shell 的python解释器路径，只影响 pyenv 自身逻辑 - 更稳妥的做法：用
pyenv virtualenv 3.9.18 myproject-39创建独立环境，然后在.envrc中source_env ~/.pyenv/versions/myproject-39/bin/activate - 注意
pyenv和direnv的初始化顺序：pyenv 的init必须在 direnv 的 hook 之前加载，否则pyenv命令不可用
真正麻烦的从来不是配置本身，而是 shell 初始化顺序、缓存残留和权限模型之间的咬合点——这些地方出问题，direnv 就会静默失效，连报错都不给你看。
