Python虚拟环境

一句话：为每个Python项目隔离依赖包，避免不同项目之间版本冲突。

它是什么

Python虚拟环境是给每个项目创建独立的依赖空间。AI项目经常依赖大量包，如模型库、向量库、Web框架和数据处理库，如果全部装在系统环境里，很容易版本冲突。虚拟环境可以让项目更稳定、更容易迁移。

适合干什么

• Python新手
• 运行AI开源项目的人
• 做RAG、爬虫、数据分析的人
• 经常遇到依赖冲突的人

不适合干什么

• 完全不使用Python的项目
• 只在一次性在线Notebook里测试的人
• 已经使用Docker完整隔离的人

普通人怎么用

• 进入项目目录
• 创建虚拟环境
• 激活虚拟环境
• 安装requirements.txt依赖
• 运行项目并记录Python版本

进阶用户怎么用

• 为每个项目固定依赖版本
• 使用requirements.txt或pyproject.toml管理依赖
• 把虚拟环境目录加入.gitignore
• 生产环境考虑Docker进一步隔离

常见误区

• 没有激活虚拟环境就安装包
• 把venv目录提交到GitHub
• 不同项目共用一个环境
• Python版本和项目要求不一致

和相似工具的区别

• 虚拟环境 vs Docker：虚拟环境隔离Python包，Docker隔离整个运行环境，包括系统依赖和服务。
• venv vs conda：venv是Python自带方案，conda更擅长管理Python版本和科学计算依赖。

入门步骤

• 确认Python版本
• 创建虚拟环境
• 激活环境
• 安装依赖
• 运行项目
• 导出依赖清单

推荐工具（第三方）

venv、pip、conda、uv、Poetry、VS Code