Python 虚拟环境入门：为每个项目准备独立依赖

在一台电脑上练习多个 Python 项目时，可能会遇到版本冲突：一个项目需要某个库的旧版本，另一个项目却需要新版本。虚拟环境可以为每个项目准备独立的第三方包目录，让项目依赖更容易管理。

创建一个练习项目

先确认系统已经安装 Python 3，然后在终端执行下面的命令：

mkdir venv-demo
cd venv-demo
python3 -m venv .venv

这里的 .venv 是虚拟环境目录名。Windows 上如果 python3 不可用，可以尝试用 py -m venv .venv。部分 Linux 发行版可能需要单独安装对应版本的 venv 软件包。

激活并确认位置

在 Linux 或 macOS 的 Bash 中执行：

source .venv/bin/activate

在 Windows PowerShell 中执行：

.\.venv\Scripts\Activate.ps1

激活后，终端提示符通常会显示环境名称。可以进一步确认正在使用的解释器：

python -c "import sys; print(sys.executable)"
python -m pip --version

输出中的路径应指向当前项目的 .venv。使用 python -m pip 的好处是：pip 会通过当前选中的 Python 解释器运行，减少把包装到其他环境的可能。

安装和记录依赖

例如，安装一个用于练习的库：

python -m pip install requests
python -m pip show requests
python -m pip freeze > requirements.txt

最后一条命令记录当前环境中已安装的包及版本，方便之后在另一个环境中恢复。注意，freeze 会列出环境里安装的包，包括间接依赖；它不是自动识别项目实际使用了哪些库。建议在干净的项目环境中生成，再检查文件内容。

别人拿到项目后，可先创建并激活自己的虚拟环境，再执行：

python -m pip install -r requirements.txt

一般应将依赖文件纳入版本管理，并在 .gitignore 中加入 .venv/。虚拟环境包含与本机路径和平台有关的文件，通常不适合直接提交或跨机器复制。不要把密码或令牌写进依赖文件。

用完如何退出？

在已激活的终端输入 deactivate 即可退出环境。关闭终端也会结束当前会话的激活状态，不会删除环境目录。下次进入项目时重新激活即可；如果不激活，也可以直接使用 .venv 中的 Python 可执行文件。

养成“一个项目一个环境”的习惯，可以让依赖问题更容易复现和排查。出现包找不到时，先检查解释器路径和 pip 版本，再决定是否重新安装。