给新手的 Python 虚拟环境与依赖管理入门：venv + pip 的一次完整实践

刚学 Python 时，很多人第一步就装包，结果越装越乱：A 项目要旧版本，B 项目要新版本，换一台电脑又不知道当初装了什么。问题不在命令记不住，而在所有项目共用同一个全局环境。虚拟环境就是给每个项目准备一个独立的“小房间”，依赖互不干扰，出了问题删掉重建也不心疼。

第一步：创建。进入项目文件夹，执行 python -m venv .venv。这会在项目里生成 .venv 文件夹，里面有独立的 Python 解释器和 pip。注意不要把 .venv 提交到代码仓库，配合 .gitignore 忽略它。

第二步：激活。Windows 用 .venv\Scripts\activate，macOS 和 Linux 用 source .venv/bin/activate。成功后命令行前面会出现 (.venv) 标记，这就是“你在虚拟环境里”的信号。退出用 deactivate。很多新手报错，其实是没有激活就直接 pip install，结果装到了全局。

第三步：装包与验证。激活后执行 pip install requests，再用 pip list 查看，用一段小代码验证 requests 是否能正常导入和查看版本。养成习惯：装包前先确认提示符里有 (.venv)，装完马上跑一小段代码，而不是等到项目写了一半才发现版本不对。

第四步：锁定依赖。执行 pip freeze > requirements.txt，把当前精确版本写下来。换环境时只要新建虚拟环境并激活，再执行 pip install -r requirements.txt，就能复现一套基本一致的依赖。平时可以把 requirements.txt 分成基础依赖和开发依赖，例如开发用的测试、格式化工具单独放 requirements-dev.txt，避免生产环境装一堆用不上的包。

常见坑有四点：一是虚拟环境建在项目外、路径里有中文或空格，容易找不到；二是多个 Python 版本共存时，先用 python --version 和 which python（Windows 用 where python）确认用的是哪一个；三是升级 pip 先用 python -m pip install --upgrade pip，避免 pip 本身版本太旧；四是不要在虚拟环境里用 sudo 或管理员权限装包，那会破坏隔离的意义。

一套可复制的流程是：建项目文件夹、创建 .venv、激活、升级 pip、安装依赖、写 requirements.txt、提交代码时忽略 .venv。每次换电脑或换项目，重复这几步即可。虚拟环境不是高级技巧，而是 Python 开发的基本卫生习惯，先把环境管干净，之后学框架、做接口、部署服务都会少走很多弯路。