Python 虚拟环境笔记

Python 项目最常见的问题之一是依赖混乱。虚拟环境的作用就是把不同项目的依赖隔离开，避免 A 项目升级包以后把 B 项目搞坏。

创建虚拟环境

python -m venv .venv

推荐把虚拟环境放在项目根目录，命名为 .venv。

macOS / Linux：

source .venv/bin/activate

Windows PowerShell：

.\.venv\Scripts\Activate.ps1

激活后，终端前面通常会出现 (.venv)。

pip install requests
pip install -r requirements.txt

保存依赖：

pip freeze > requirements.txt

deactivate

先确认：

which python
which pip

如果路径不在 .venv 里，说明虚拟环境没有激活。

pip freeze 会把所有间接依赖也写进去。小项目可以接受，大项目建议使用 pyproject.toml、uv 或 Poetry 管理依赖。

虚拟环境不会自动解决 Python 解释器版本问题。创建环境前要先确认：

python --version

环境问题越早规范，后面协作越省时间。