为什么要给 Python 小脚本单独建 venv
刚学 Python 时,最常见的情况是:写了一个小脚本,需要装个第三方库,于是直接执行 pip install。过一阵子再写另一个脚本,又装了几个版本不同的库,结果两个脚本互相影响,某天突然跑不起来,也分不清是哪次安装造成的。
虚拟环境(venv)解决的就是这个问题。它为每个项目建立一套独立的 Python 解释器链接和依赖目录,装在里面的包只属于这个项目,不会污染系统或其他项目。对于只有几个文件的小脚本,建一个 venv 的成本很低,但能省下大量排查时间。
下面按系统分别说明创建和激活的命令,然后重点讲如何判断自己是否真的处于虚拟环境中,以及激活后仍然出问题时怎么处理。
第一步:确认 Python 版本
先在终端确认能调用的 Python 版本。在 Windows 上通常使用 py,在 Linux 和 Mac 上通常使用 python3。
python3 --version
Windows 用户可以执行:
py --version
如果提示找不到命令,说明 Python 没有安装好,或没有加入系统路径,需要先解决这个问题,再继续创建虚拟环境。
第二步:在项目目录中创建 venv
进入脚本所在的文件夹,然后创建虚拟环境。习惯上把环境目录命名为 .venv,它会被放在项目目录里,便于识别和迁移。
Linux 或 Mac:
cd ~/my_script
python3 -m venv .venv
Windows(命令提示符或 PowerShell):
cd %USERPROFILE%my_script
py -m venv .venv
执行完成后,项目目录下会多出一个 .venv 文件夹。它保存的是这个项目专用的 Python 和后续安装的包,不需要手动修改其中的内容。
在部分 Debian、Ubuntu 系统上,如果提示缺少 ensurepip 相关模块,通常需要先通过系统包管理器安装对应的 venv 支持包,然后再重新创建。具体包名取决于你的系统版本和 Python 版本,可以根据报错信息中的提示操作。
第三步:激活虚拟环境
创建完成后,还需要激活,让终端里的 python 和 pip 指向这个环境。
Linux 或 Mac(bash 或 zsh):
source .venv/bin/activate
Windows PowerShell:
..venvScriptsActivate.ps1
Windows 命令提示符(cmd):
.venvScriptsactivate.bat
激活成功后,命令行提示符前面通常会出现 (.venv) 之类的标记。这个标记只是提示,不能作为唯一的判断依据,下一节会介绍更可靠的方法。
如果在 PowerShell 中提示“无法加载文件,因为在此系统上禁止运行脚本”,可以在当前用户范围内调整执行策略后再尝试。这属于系统安全设置,修改前应确认自己理解其影响。
如何确认当前是否处于虚拟环境中
这是判断环境是否正确的关键步骤。不要只看提示符是否带有括号,因为提示符可能是由其他配置或脚本修改的,也可能激活时出现异常但仍显示了标记。
更可靠的方法是检查 Python 实际使用的路径。激活后执行:
Linux 或 Mac:
which python
which pip
Windows:
where python
where pip
如果输出的路径位于项目目录下的 .venv 中,说明当前 python 和 pip 已经指向虚拟环境。如果路径仍然指向系统安装目录或用户全局安装目录,说明激活没有生效。
另一个判断方式是让 Python 自己报告运行环境:
python -c "import sys; print(sys.prefix)"
在虚拟环境中,这个输出通常指向项目下的 .venv 目录;如果输出的是系统 Python 的安装目录,则说明当前并不处于该虚拟环境中。这个方法不依赖提示符,判断结果更直接。
第四步:在虚拟环境中安装依赖
确认激活成功后,再安装脚本需要的库。这样安装的包只会进入当前 .venv。
pip install requests
安装完成后,可以把依赖导出到文件中,方便以后在其他电脑上复现环境:
pip freeze > requirements.txt
以后在新环境中,只需激活 venv 后执行 pip install -r requirements.txt 即可。
常见故障一:激活后 pip 仍指向全局环境
这是最常见的问题。典型表现是激活后执行 pip install 时,包仍然被装到了系统 Python 中,或者 sys.prefix 仍然指向系统目录。
可以按以下顺序排查:
先确认是否真的执行了激活命令,并且路径没有写错。在 Linux 或 Mac 中,source 要在项目目录下执行,并且 .venv 目录确实存在。如果当前目录不对,source .venv/bin/activate 会找不到文件。
其次检查终端是否是在同一个会话中执行的。有些情况下,先激活,再开新终端,新终端不会自动继承激活状态,需要重新激活。
如果已经误装到全局环境,不必慌张。可以先停用当前环境,再查看全局包列表,确认是否需要卸载。停用命令是:
deactivate
然后检查对应 Python 的安装情况。卸载全局包前,应确认该包没有被系统工具或其他程序使用,避免影响正常软件。
常见故障二:提示找不到命令
激活后执行 pip 或 python 提示“找不到命令”,常见原因有三类。
一是 .venv 目录创建不完整。可以删除 .venv 文件夹后重新创建,这比逐个修补更省时间。删除的只是这个项目的虚拟环境,不会影响源代码,但要注意目录中是否有你手动放入的重要文件。
二是激活脚本路径写错。Windows 下激活脚本位于 Scripts 目录,Linux 和 Mac 下位于 bin 目录。两者不要混用。
三是 Python 本身没有正确安装或没有加入系统路径。此时即使能创建 venv,激活后也可能找不到基础命令。需要先确认系统中能正常调用 Python。
常见故障三:权限受限
在 Linux 或 Mac 上,如果创建或安装时提示“Permission denied”,通常是因为项目目录属于 root 用户,或者你在系统目录中尝试创建环境。
解决方法是把 venv 建在自己有写权限的目录中,例如个人用户主目录下的项目文件夹,而不是系统目录。不要为了解决这类问题直接使用 sudo pip install,这会把包装进系统环境,反而可能引发新的冲突。
在 Windows 上,如果项目放在受保护的位置,例如某些系统目录或其他用户的文件夹中,也可能出现写入失败。把项目移动到个人文档或其他有写权限的目录,通常更稳妥。
一个可复用的检查流程
为了方便以后每次新建脚本时快速操作,可以按下面的顺序执行:
- 进入项目目录,确认目录存在且有写权限。
- 创建
.venv。 - 激活虚拟环境。
- 用
which python、where python或sys.prefix确认路径指向.venv。 - 安装所需依赖,并导出
requirements.txt。 - 运行脚本,确认能正常执行。
只要每个新脚本都按这个流程建立环境,大多数由全局安装引起的混乱都可以避免。虚拟环境本身并不复杂,真正容易出错的通常是激活状态的确认和路径问题,所以在第四步之前花半分钟检查一下,往往能省下后面大量的排错时间。








