开发环境搭建：Python虚拟环境与依赖管理

002、开发环境搭建：Python虚拟环境与依赖管理

昨天调试同事的FastAPI项目时，又遇到了经典的依赖冲突问题——他的本地环境能跑，我的机器上死活起不来。uvicorn启动直接报ImportError，一查发现是pydantic版本不匹配。这种问题在团队协作中太常见了，根源往往在于环境隔离没做好。今天咱们就彻底解决这个问题。

为什么非用虚拟环境不可？

很多新手喜欢直接pip install装全局环境，初期确实省事。但当你同时维护两个项目，一个需要fastapi==0.68.0，另一个需要fastapi==0.90.0时，灾难就来了。更别提有些系统工具依赖特定Python包版本，全局升级可能把系统组件搞崩。

虚拟环境本质上是目录隔离：每个项目有自己的site-packages，互不干扰。就像给每个项目分配独立的实验室，试剂瓶不会混放。

实战：venv方案（Python原生推荐）

Python 3.3+自带venv模块，无需额外安装。我习惯在项目根目录操作：

# 创建虚拟环境，目录名用.venv是行业惯例（.gitignore通常已包含）python