venv 创建虚拟环境时不能用系统 Python 直接 pip install，因为会污染全局 site-packages 并影响系统工具；其核心价值是依赖隔离，每个 Flask 项目独占一套依赖。
venv 创建虚拟环境时为什么不能用系统 Python 直接 pip install？
因为系统 Python 的 site-packages 是全局共享的，直接装包会污染其他项目甚至系统工具（比如 pip 自身升级后可能让系统命令失效）。venv 的核心价值就是隔离——每个 Flask 项目独占一套依赖。
实操建议：
- 始终在项目根目录下运行
python -m venv venv（不推荐叫env，容易和某些旧脚本冲突） - Windows 下激活用
venv\Scripts\activate.bat，macOS/Linux 用source venv/bin/activate - 激活后终端提示符通常会变，且
which python（或where python）应指向项目内venv/...路径 - 别手动复制已有的
venv文件夹——二进制路径硬编码在里面，直接复制会导致ImportError或找不到解释器
Flask 项目里 pip install 总失败？检查这三点
常见错误现象：装 flask 报 Could not find a version that satisfies the requirement，或者装完运行时报 ModuleNotFoundError: No module named 'flask'。
原因往往不是网络或版本问题，而是环境没真正切换过去：
立即学习“Python免费学习笔记（深入）”；
- 确认是否已激活虚拟环境——没激活时
pip默认走系统路径，pip list看不到刚装的包 - 检查是否误用了系统自带的
pip：运行pip --version，输出里必须含venv字样路径 - PyPI 镜像源配置是全局的，但虚拟环境里不会自动继承；如果公司网络限制，需在激活后单独配：
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
requirements.txt 怎么生成才靠谱？
很多新手用 pip freeze > requirements.txt 导出全部包，结果部署时多装了开发工具（如 black、pytest），还可能把本地调试用的 ipdb 带进去。
更稳妥的做法：
- 只导出真正被代码 import 的依赖：
pipreqs . --force（需先pip install pipreqs） - 手动维护更可控：先
pip install flask==2.3.3这类明确版本，再写入requirements.txt，避免flask后续自动升到不兼容的 3.x - 区分环境：生产环境用
requirements.txt，开发额外建requirements-dev.txt放测试/格式化工具
Python 版本不匹配导致 venv 创建失败怎么办？
错误信息类似：Error: Command '['/path/to/python', '-Im', 'ensurepip', '--upgrade', '--default-pip']' returned non-zero exit status 1。
本质是 venv 模块依赖解释器内置的 ensurepip，而某些精简版 Python（如 Ubuntu 的 python3-minimal）默认不带 pip。
解决路径：
- Ubuntu/Debian 用户先装完整包：
sudo apt install python3-venv python3-pip - macOS 用 pyenv 管理多版本时，确保当前版本是用
--enable-shared编译的（否则venv可能报错） - Windows 上如果用 Microsoft Store 安装的 Python，建议卸载，改用官网下载的安装包（勾选 “Add Python to PATH” 和 “Install pip”）
复杂点在于：venv 不是“一次创建永久可用”，它绑定创建时的 Python 解释器路径。换机器、重装系统、甚至升级 Python 小版本后，都得重建 venv——这点容易被忽略，尤其在 CI/CD 流水线里硬编码了旧路径就直接挂掉。
