【第39期】Python 第三方包安装详解：pip、conda、requirements、版本锁定和镜像源

CSDN 完整教程

系列：《从小白到 AI 大模型开发工程师的进阶之路》技术点：AI-0127 第三方包安装主人公：小蓝伞

本文是第 39 期，围绕【pip、conda、requirements、版本锁定和镜像源】展开。示例用于复现实验；标注【建议验证】的部分需要按读者自己的 Windows、Python 版本和网络条件执行。

一、问题背景与适用场景

为项目建立 .venv，安装 requests，导出 requirements.txt 并确认使用的是该虚拟环境。本期要把概念落成一个可观察、可回滚的小实践。

二、先给结论

先确定解释器，再用 python -m pip；依赖放在独立虚拟环境中并记录清单，安装后验证导入和版本。本期最小产出：依赖清单。

三、前置准备

Windows 10/11，建议 Python 3.11 或项目采用的兼容版本。
练习目录：D:\ai-learning\issue-39；涉及文件、依赖或配置时先备份。
不要提交 Token、密码和个人路径；未执行命令不得写成实测结果。

四、最小可复现实践

在练习目录保存并执行：

复制代码

# PowerShell，项目根目录执行
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install requests
.\.venv\Scripts\python.exe -m pip freeze > requirements.txt
.\.venv\Scripts\python.exe -c "import requests; print(requests.__version__)"

预期结果：最后打印 requests 版本并生成依赖清单；命令需按本机网络建议验证。

版本管理要区分两种文件：requirements.txt 是当前环境快照；直接依赖可以在项目的 requirements.in 或 pyproject.toml 中写成 requests>=2.31,<3，再在干净环境验证解析结果。若组织有可信镜像源，可在安装命令中追加 --index-url <可信镜像地址>，不要为了绕过证书或网络错误随意关闭校验。使用 conda 时可改为 conda create -n ai-demo python=3.11，不要把 conda 环境和 venv 混为一个环境。

五、关键原理与工程判断

1. 先定义输入和成功判据

先确定解释器，再用 python -m pip；依赖放在独立虚拟环境中并记录清单，安装后验证导入和版本。

2. 保留状态和失败原因

把输入、输出、版本、目录和完整错误记入 README 或日志，便于定位而不是只写【失败】。

3. 小步执行与回滚

先跑最小样例，再一次改一个变量；危险操作先 dry-run、备份或 Git 提交。

六、常见问题与避坑

pip 与运行程序不是同一个解释器；使用 python -m pip 或虚拟环境的绝对路径。
直接安装到全局环境造成项目互相污染；每个项目使用独立 .venv。
只写包名不记录版本和来源；导出依赖清单并在干净环境重装验证。

七、验证清单

正常、边界、失败三类输入均有验证。
重新打开终端或进程后复验，排除缓存和当前会话影响。
产物能再次读取、运行或恢复；未实测部分标记【建议验证】。

八、面试题

本期技术点解决什么问题？解决输入、状态或失败边界的可控性。
为什么先做最小实践？降低变量数量，区分语法、环境和业务问题。
出现错误先做什么？保存完整错误，确认版本、目录、权限和输入。
如何判断真正生效？重启相关进程后，用独立命令和功能测试复核。
什么时候不能照搬示例？系统、版本、权限或输入契约不同，就要先调整并阅读官方文档。

九、本期小结与下一期

本期完成依赖清单，把正确路径和失败路径都变成可验证动作。下一期继续学习资料库中的下一个技术点。点个关注不迷路，跟着小蓝伞把 Python 基础变成工程能力。可靠的程序也要能解释失败。

官方资料

Installing Packages - Python Packaging User Guide