本文介绍如何强制 Python 脚本严格运行在纯净虚拟环境中，避免意外依赖全局或用户级已安装包，从而保证 requirements.txt 的完整性与部署一致性。
本文介绍如何强制 python 脚本严格运行在纯净虚拟环境中，避免意外依赖全局或用户级已安装包，从而保证 `requirements.txt` 的完整性与部署一致性。
在 Python 项目开发中，创建虚拟环境（venv）的核心目标是实现依赖隔离：脚本应仅使用 venv 中显式安装的包，而非系统或用户目录下的“幽灵依赖”。然而，许多开发者会遇到这样的问题：明明新建了一个空虚拟环境（仅含 pip/setuptools/wheel），但脚本仍能正常运行——这是因为 Python 默认启用了 user site-packages（用户站点包）机制，会自动将 ~/.local/lib/pythonX.X/site-packages/ 下的包加入 sys.path，导致看似“干净”的 venv 实际上悄悄加载了全局第三方库。
这会带来严重隐患：你可能遗漏 pip freeze > requirements.txt 中的关键依赖，本地测试通过，但部署到服务器时因缺少对应包而直接报错（如 ModuleNotFoundError）。
✅ 正确做法：使用 -s（--no-site-packages）命令行标志
该标志明确禁用所有外部站点包（包括用户和系统 site-packages），强制 Python 仅搜索当前虚拟环境的 site-packages 目录：
python -s script.py
⚠️ 注意：-s 是 Python 3.12+ 的默认行为（即 venv 默认不继承用户包），但在旧版本（如 3.8–3.11）中仍需显式指定。为兼容性和可重复性，强烈建议始终加上 -s。
? 验证是否生效
在激活虚拟环境后，运行以下命令对比差异：
# 默认行为（可能包含 ~/.local/...）
python -c "import sys; print('\n'.join(sys.path))"
# 强制纯净模式（路径中不应出现 ~/.local）
python -s -c "import sys; print('\n'.join(sys.path))"
若后者输出中仅包含 venv 路径（如 .venv/lib/python3.x/site-packages）且无 ~/.local 或 /usr/local/lib 等路径，则说明隔离成功。
? 最佳实践建议：
- 在开发阶段，始终用 python -s script.py 运行脚本，及早暴露缺失依赖；
- 生成 requirements.txt 前，确保所有依赖均已通过 pip install -e . 或 pip install xxx 安装到当前 venv；
- 使用 pip freeze --exclude-editable > requirements.txt（如需排除可编辑安装）；
- CI/CD 或生产部署脚本中，统一使用 python -s 启动主程序；
- （进阶）在 pyproject.toml 中配置 [[tool.black]] 或 [[tool.ruff]] 等工具时，也建议在隔离环境中安装并运行，避免工具链污染。
通过 -s 标志，你不仅保障了本地开发与生产环境的一致性，更将“依赖可见性”真正交还给开发者——每一行 import 都应有据可查，每一份 requirements.txt 都值得信赖。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
