Python 虚拟环境入门：让每个项目使用自己的依赖

同一台电脑上的两个Python项目，可能需要不同版本的依赖包。虚拟环境可以让项目各自维护一份安装位置，减少互相影响。本文先用Python自带的venv完成最小流程，不要求安装额外的环境管理器。

创建环境之前确认Python命令

本文命令以已有Python 3为前提。macOS和Linux通常使用python3；Windows可以先检查Python启动器py。先运行版本查询，确认命令能够执行，再进入自己的项目目录。

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

Windows可将创建命令写成py -m venv .venv。部分Linux发行版需要另行安装发行版提供的venv支持包；应按系统文档处理，不要盲目用管理员权限安装项目依赖。

激活与直接调用是两种方式

# macOS / Linux，bash或zsh
source .venv/bin/activate

# Windows PowerShell
.\.venv\Scripts\Activate.ps1

激活的主要作用是让当前终端更方便地找到环境内的解释器。它不是必须步骤：macOS/Linux可直接运行.venv/bin/python，Windows可直接运行.venv\Scripts\python.exe。若PowerShell阻止激活脚本，可以先用解释器完整路径，不必为这个练习放宽全机安全策略。

确认安装位置，而不是只看提示符

python -c "import sys; print(sys.executable); print(sys.prefix != sys.base_prefix)"
python -m pip --version

在环境内执行时，解释器路径应指向项目的.venv目录，第二个表达式通常应为True。安装包时采用python -m pip，可以减少pip和当前Python不匹配的情况。示例检查在本地Python环境验证过，Windows命令按官方文档核对。

记录依赖并学会重建

python -m pip freeze > requirements.txt
# 在新建且已激活的环境中恢复
python -m pip install -r requirements.txt
# 退出当前终端的环境
deactivate

requirements.txt记录的是这次环境中的安装版本，不自动解决跨操作系统兼容性，也不等于带哈希的完整供应链锁定。通常不把.venv目录提交到Git，而是保存代码和依赖声明，换机器后重新创建环境。删除环境前确认路径，避免把项目源码一起删掉。

资料与延伸阅读

• Python官方：venv

继续阅读：用Python清洗CSV并导出JSON · Docker Compose的最小练习

资料查阅与编辑日期：2026年9月22日。作者：玖柒。