venv 激活后 python -V 仍显示 3.10 虚拟环境不生效怎么排查

现象

在项目目录执行 sourCe venv/bin/activate,命令行前面也出现了 (venv) 前缀,但 python -V 仍然显示 3.10,pip install 装完的包在脚本里依旧导入不了。退出重进、删掉重建虚拟环境,现象一模一样。

原因

激活只是改了 PATH 的顺序,并不保证 python 一定来自 venv。常见原因是创建环境时用了 --system-site-packages,或者 venv 目录被整体拷贝、移动过,bin 里的 python 软链接还指向老路径。另外 shell 里设过 alias python 或 pyenv shims 优先级更高,也会把 PATH 顶掉。

解决步骤

第一步,看看到底调用了哪个 python。同时打印 PATH,确认 venv 的 bin 目录是否排在系统目录前面。

which python
python -c "import sys; print(sys.prefix)"
echo $PATH | tr ':' '\n' | head -5

第二步,重建环境,不要在旧目录上修。用 python3.12 -m venv venv 重新生成,创建时不要加 --system-site-packages;已经把目录搬过位置的,直接删掉重建最省事。

第三步,清掉 shell 层的干扰。检查 alias python、pyenv global 和 ~/.bashrc 里指向系统 Python 的 export PATH,把排在虚拟环境前面的那几行删掉,重新 source 后再激活。

验证

python -V 显示 3.12.x,sys.prefix 指向项目下的 venv 目录,pip -V 的路径也在 venv/bin 里,装一个包后 python -c 能导入,三项一致即可。

小结

venv 不生效基本是 PATH 和软链接的问题。先看 sys.prefix 再决定是修还是重建,比重装依赖快得多。

您可以还会对下面的文章感兴趣: