必须先激活venv才能运行pip install -r requirements.txt,否则pip会指向系统全局路径,导致依赖装入系统site-packages而失去隔离;激活后终端显示(venv)提示且which pip返回venv路径才安全。

pip install -r requirements.txt 是唯一正确、标准的安装方式。其他任何“先手动 pip install 再导出”或“用 pip list 重写文件”的做法,都是绕远路,且容易漏掉版本约束或可选依赖。
为什么必须先激活 venv 才能运行 pip install -r requirements.txt
虚拟环境的本质是隔离 python 和 pip 的执行路径。未激活时,你敲的 pip 很可能指向系统全局 pip(比如 /usr/bin/pip),哪怕命令成功,库也会被装进系统 site-packages,完全失去隔离意义。
激活后终端出现 (venv) 或 (.venv) 提示,才是安全信号。此时 which pip(macOS/Linux)或 where pip(Windows)会返回类似 venv\Scripts\pip.exe 或 venv/bin/pip 的路径。
- Windows CMD/PowerShell:运行
.venv\Scripts\activate(假设虚拟环境叫.venv) - macOS/Linux:运行
source .venv/bin/activate - 确认是否生效:执行
python -m pip --version,输出中应包含.venv路径
requirements.txt 文件本身要满足什么格式才不会报错
pip 对文件格式非常敏感,常见失败不是命令错,而是文件内容不合规:
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
- 每行只能有一个包声明,不能有空格分隔多个包(如
requests flask❌) - 注释必须以
#开头且独占一行,不能跟在包名后面(如requests==2.31.0 # http client❌,部分旧版 pip 会忽略整行) - 版本号必须用
==、>=、~=`等 pip 支持的比较符,不能写成requests 2.31.0或requests@2.31.0(后者是 PEP 508 格式,仅限某些场景) - 如果用了
-e .(可编辑安装)或-r other-reqs.txt,确保对应路径存在且可读
安装失败时最该检查的三件事
报错信息里带 ERROR: Could not find a version that satisfies the requirement 或 ConnectionError,别急着重试,先看这几处:
- 当前网络能否访问 PyPI:执行
pip install requests测试基础连通性;若公司内网需镜像源,在pip install后加-i https://pypi.tuna.tsinghua.edu.cn/simple/ -
requirements.txt里是否有本地路径或 Git 仓库依赖(如git+https://...),确认 git 已安装且 URL 可访问 - 是否存在平台限制(如
psycopg2-binary; platform_system == "Linux"),而你正在 Windows 上运行;这种条件依赖需要 pip 20.3+,老版本会直接跳过或报错
安装完怎么验证是不是真装进了 venv
别只信 “Successfully installed”,要亲手确认:
- 运行
python -m pip list,输出的包列表应和requirements.txt内容基本一致(可能多出pip、setuptools等基础工具) - 运行
python -c "import requests; print(requests.__file__)",路径必须落在.venv目录下(如.venv\Lib\site-packages\requests\__init__.py),而不是C:\Python39\Lib\site-packages或/usr/local/lib/python3.11/site-packages - 退出虚拟环境(
deactivate)后再运行python -c "import requests",应抛出ModuleNotFoundError—— 这才是隔离生效的铁证
实际项目中,最容易被忽略的是:requirements.txt 里混入了开发期临时安装但未删掉的调试工具(如 ipdb、black),导致生产环境也装了一堆非运行时依赖。这类包应该单独放在 dev-requirements.txt 里,用 pip install -r dev-requirements.txt 区分管理。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










