现象
在项目目录执行 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 再决定是修还是重建,比重装依赖快得多。
