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 音频与音乐分析库

librosa 是一个用于音频和音乐分析的 Python 库。它提供了特征提取、频谱分析、节拍跟踪、起始检测和音频可视化的工具，基于 NumPy 和 SciPy 构建，用于科学音频计算。

下载

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 就会静默失效，连报错都不给你看。

Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！