venv是Web开发防止项目崩溃的底线配置，通过隔离site-packages避免Django/Flask等框架因版本冲突导致ImportError，必须配合requirements.txt在激活环境中使用，确保本地、测试、生产环境依赖一致。
venv 不是 Web 开发的附加选项，而是防止项目当场崩溃的底线配置。
Web 项目依赖链长、版本敏感、部署环境多变——不隔离，pip install 就像在雷区里换电池。
为什么 Django/Flask 项目一升级就报 ImportError: cannot import name '...' from 'django'
典型现象：本地开发用 Django 4.2 正常，上线前升级到 4.3，结果 manage.py runserver 直接炸；或者同事拉代码后 python app.py 报错说找不到 flask_login，但你明明 pip list 里有。
根本原因不是代码写错了，而是：全局 Python 环境里混装了多个 Web 框架版本，或不同项目共用同一套 site-packages。Django 4.3 移除了某个向后兼容的内部函数，而你的旧项目代码还硬引用它；Flask 插件如 Flask-SQLAlchemy 对 SQLAlchemy 版本有强约束，全局装了 SQLAlchemy 2.0，但你的项目只适配 1.4 —— 这些冲突不会提前报错，直到 import 那一行才暴露。
- Web 框架本身迭代快（Django 平均半年一个 feature release），API 变更频繁
- 中间件、ORM、模板引擎、认证扩展等子模块版本必须严格对齐
-
requirements.txt记录的是“精确版本组合”，不是“任意能装上的包”
本地开发、测试服务器、生产环境三处 Python 解释器怎么保持一致？
答案不是靠人肉记忆“我在 XX 机器上装过什么”，而是靠 venv + requirements.txt 的闭环。
你执行 python -m venv .venv 创建环境后，所有后续操作都绑定在这个沙盒里：pip install -r requirements.txt 安装的包只存在 .venv/lib/python3.x/site-packages/ 下；python manage.py migrate 调用的也是这个环境里的 django；就连 IDE（如 VS Code）识别解释器时，也必须指向 .venv/bin/python（macOS/Linux）或 .venv\Scripts\python.exe（Windows）。
立即学习“Python免费学习笔记（深入）”；
- 别用系统自带的
/usr/bin/python3或C:\Python39\python.exe直接跑 Web 服务 -
pip freeze > requirements.txt必须在激活的虚拟环境中执行，否则导出的是全局包列表 - CI/CD 流水线（如 GitHub Actions）应明确用
python -m venv创建新环境，再pip install，避免缓存污染
为什么 pip list 显示的包和实际 import 的不一致？
这是最常被忽略的“假成功”陷阱：你敲了 pip install flask，pip list 看起来有 Flask，但 import flask 还是报错。
本质是没激活环境，或者终端窗口没刷新 PATH —— 你看到的 pip list 是全局的，而 python 命令调用的却是系统解释器。验证方式很简单：
python -c "import sys; print(sys.executable)"
输出如果是 /usr/bin/python3 或 C:\Python39\python.exe，说明根本没进虚拟环境；正确输出应类似 /path/to/project/.venv/bin/python。
- Linux/macOS：运行
source .venv/bin/activate后，命令行提示符通常会显示(.venv) - Windows：用
.venv\Scripts\activate.bat（CMD）或.venv\Scripts\Activate.ps1（PowerShell，需先Set-ExecutionPolicy RemoteSigned -Scope CurrentUser） - VS Code：按
Ctrl+Shift+P→ “Python: Select Interpreter” → 手动选中.venv下的 python
删项目时怎么确保不留下“幽灵依赖”影响下一个 Web 项目？
直接 rm -rf project_dir 就够了 —— 虚拟环境目录（比如 .venv）是项目文件夹的一部分，删项目等于连环境一起清空。
不需要 pip uninstall django flask ...，也不用担心“卸载不干净”。因为所有包物理路径都在 .venv 内部，不存在跨项目残留。
- 别把虚拟环境建在共享目录（如
/home/user/envs/），否则删项目时容易漏掉 - Git 里要加
.venv/到.gitignore，但别加requirements.txt—— 它是环境复现的关键契约 - 如果用了
conda，注意它默认把环境放在统一目录（~/anaconda3/envs/），删除需手动conda env remove -n myweb
venv，而是忘记它存在、混用解释器、或者误信“我这个小项目不用隔离”。Web 项目一旦接入数据库迁移、异步任务、OAuth 登录、静态文件收集，依赖耦合度就指数级上升 —— 那时再补虚拟环境，不如重搭。 
