Python pip使用教程：安装、验证与管理依赖

先确认pip属于哪套Python

安装任何依赖之前都要先确认解释器和包管理器的对应关系，否则安装成功也可能在实际运行项目时无法导入。

在新终端中依次运行：

python --version
where python
python -m pip --version

第一条显示解释器版本，第二条列出Windows找到的Python路径，第三条显示pip版本和所在目录。pip路径应当能解释它属于哪套Python。如果使用py启动器，也可以用py -m pip --version检查启动器默认版本。虚拟环境激活后再次运行这些命令，路径应转向项目的.venv目录。

pip常用命令表

常用命令应按查看、安装、验证、记录和卸载的顺序理解，每次操作都要关注当前环境与目标包是否一致。

不要直接复制未知命令并以管理员权限执行。安装包前先访问项目文档确认名称，例如导入名和发布名可能不同。安装完成后使用show查看位置，再在同一终端中运行最小导入测试。

安装并验证一个第三方包

一次完整的依赖安装不仅包括执行安装命令，还包括确认环境、检查包信息并由同一解释器完成实际导入测试。

1. 1.进入项目目录，确认是否需要先激活虚拟环境。
2. 2.运行python -m pip --version，记录解释器和pip位置。
3. 3.运行python -m pip install 包名，完整阅读最后几行输出。
4. 4.使用python -m pip show 包名确认版本和安装目录。
5. 5.使用python -c "import 包的导入名; print('ok')"做最小验证。
6. 6.项目稳定后记录依赖版本，不要只依赖本机环境记忆。

安装成功但代码仍提示ModuleNotFoundError时，最常见原因是编辑器或运行命令使用了另一套Python。把终端中的where python、编辑器解释器路径和pip show位置放在一起比较，比重复安装更有效。

requirements.txt应该怎么用

requirements.txt是依赖清单，不是完整项目备份。它通常记录包名和版本，方便在新环境中重新安装。直接在长期使用的全局环境执行pip freeze可能导出大量与项目无关的包，因此更推荐先创建虚拟环境，只安装项目依赖后再导出。

安装清单前先阅读文件，确认没有不认识的私有地址、可编辑本地路径或平台不兼容的固定版本。依赖解析失败时，不要立即删除全部版本约束；先找出冲突的两个包和它们要求的版本范围，再决定升级项目、调整包版本或更换Python版本。

pip不可用时的排查顺序

包管理异常可能来自命令入口、解释器归属、网络连接或证书策略，按层次检查比重复安装更容易找到真实原因。

如果pip不是内部或外部命令，但python可以运行，先尝试python -m pip --version。独立的pip快捷命令可能没进入PATH，而模块仍然存在。若提示没有pip模块，可根据官方安装模块文档检查python -m ensurepip --default-pip是否适用于当前解释器，再重新验证。

出现证书、代理、超时或连接失败时，先确认系统时间、企业代理和网络策略。不要为了绕过错误关闭证书验证，也不要随意使用来历不明的镜像。确需使用组织或可信镜像时，应明确记录来源和配置范围，避免把临时参数复制到所有项目。

出现“没有匹配的分发版本”时，要同时看Python版本、系统架构、操作系统和包的发布范围。有些包不再为结束支持的Python版本提供新构建，这种情况下反复重试网络不会解决问题。可以评估受支持的Python版本，或按项目文档选择兼容的包版本。

与虚拟环境配合

项目开始出现第三方依赖后，应把全局工具和项目依赖分开管理，让终端、编辑器和部署脚本使用同一环境路径。

当项目开始安装第三方包时，进入venv虚拟环境教程创建.venv。激活后再执行python -m pip，依赖会进入该项目环境。退出环境后，全局Python不应自动看到这些包，这正是隔离生效的表现。

如果Python命令本身不可用，先查看安装教程和PATH排查。尚未运行过脚本的用户可以先完成Python新手教程，避免在解释器和项目目录尚未明确时引入更多变量。

每次新增依赖后都运行一次项目的最小功能检查，并记录安装命令。仅凭pip list看到包名并不能证明程序使用正确，真正的成功标准是同一解释器可以导入该包，而且项目测试或最小脚本得到预期结果。