Python 虚拟环境配置最佳实践

2026-08-24

Python 虚拟环境是每个 Python 项目的必备工具,它为每个项目创建独立的依赖环境,避免不同项目之间的包版本冲突。

创建虚拟环境

# 创建虚拟环境
python3 -m venv .venv

# 激活虚拟环境
source .venv/bin/activate   # Linux/macOS
.venv\Scripts\activate      # Windows

# 退出虚拟环境
deactivate

依赖管理

# 安装依赖
pip install requests flask

# 导出依赖列表
pip freeze > requirements.txt

# 从文件安装依赖
pip install -r requirements.txt

使用 pyproject.toml

现代 Python 项目推荐使用 pyproject.toml 替代 setup.pyrequirements.txt

[project]
name = "my-project"
version = "1.0.0"
dependencies = [
    "requests>=2.28",
    "flask>=3.0",
]
💡 提示:始终将 .venv/ 加入 .gitignore,不要把虚拟环境提交到版本控制。