28｜包、虚拟环境与 pip 依赖管理

这套课程按知识依赖排列。本篇的前置知识是：第 02、27 篇。学完后，你应该能够隔离项目解释器和第三方依赖。

本篇要解决的问题

本篇只处理“包、虚拟环境与 pip 依赖管理”这一件事。示例基于 Python 3.14.6，在 macOS 环境核验；除明确标注的终端命令外，代码本身只使用 Python 标准能力。

先看清一个容易误解的细节

虚拟环境在项目边界内提供独立解释器入口和包目录。激活只是在当前终端调整命令查找顺序，不会改变 Python 语言本身。

核心概念

• .venv 是常见目录名，不应提交到 Git。
• 安装包前先确认当前解释器路径，避免装进另一个环境。
• 本基础系列示例优先使用标准库，不要求安装第三方包。

跟着示例运行

在 macOS 终端执行：

python3 -m venv .venv
source .venv/bin/activate
python --version
python -m pip --version
deactivate

预期结果：

Python 和 pip 的路径应指向当前项目的 .venv

输出中包含环境路径、集合元素或日志格式时，具体文字和顺序可能随本机环境变化；判断是否成功应以本篇说明的关键结果为准。

按执行顺序拆开看

1. venv 根据当前 python3 创建项目自己的环境目录，包含解释器入口和包安装位置。
2. 激活后 python 与 python -m pip 优先指向 .venv；deactivate 只恢复当前终端的命令查找。

初学者容易混淆的地方

• 创建环境后忘记激活，依赖被安装到全局或另一个环境。
• 把 .venv 提交到 Git。环境应通过依赖清单重建，不应跨机器复制。

练习

1. 创建虚拟环境并记录激活前后的 which python。
2. 退出后重新激活，确认项目环境可以重复使用。

练习应先独立完成，再通过增加 print 输出或检查文件内容观察中间状态。当前课程尚未讲到的能力，不要求提前搜索复杂写法。

本篇边界

本篇目标是隔离项目解释器和第三方依赖。没有展开的高级机制会放到后续课程；先确保能够解释示例中每一行代码，再进入下一篇。