Python 虚拟环境

学习venv · 难度：进阶 · +15XP

Python 虚拟环境

Python 虚拟环境 — 隔离项目的依赖

学习前的准备

你需要 Python 3.3 以上版本（venv 模块自带）。虚拟环境解决了“不同项目需要不同版本库”的根本问题。

创建虚拟环境

# 创建虚拟环境
python -m venv my_env
# 推荐命名：venv、env、.venv
# 建议添加到 .gitignore 中

激活和使用

# Windows
my_env\Scripts\activate
# macOS / Linux
source my_env/bin/activate
# 现在 pip install 只影响这个环境
pip install requests
pip list
# 退出虚拟环境
deactivate

导出和重建环境

# 导出依赖列表
pip freeze > requirements.txt
# 重建环境
python -m venv new_env
new_env\Scripts\activate
pip install -r requirements.txt

最佳实践

1. 每个项目一个环境——不要复用。
2. 环境文件夹不要提交——加入 .gitignore。
3. 始终提交 requirements.txt——让所有人都能重现环境。
4. 使用一致的 Python 版本——在 README 中注明。

小结

虚拟环境让每个项目拥有独立的 Python 环境和包集合。创建用 python -m venv，激活用 activate 脚本，导出用 pip freeze > requirements.txt，重建用 pip install -r requirements.txt。从今天开始，开启任何新 Python 项目前，第一件事就是创建虚拟环境。