1. 什么是 pip？ #

• Pip 官网
• pip 是 Python 官方的包管理工具，用来安装、升级、卸载第三方库。
• 名称来自 Pip Installs Packages，可从 PyPI（Python 官方软件仓库）下载包。
• 日常开发中几乎所有项目都通过 pip 管理依赖，是必须掌握的基础工具。

包名	用途
requests	发送 HTTP 请求
pandas	数据处理
django / flask	Web 开发

# 命令行安装
pip install requests

Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple
Requirement already satisfied: requests in c:\users\administrator\appdata\local\programs\python\python313\lib\site-packages (2.32.5)

import requests
response = requests.get('https://www.example.com')
print(response.status_code)

2. 为什么需要 pip？ #

• 没有 pip 需要手动下载源码、编译、处理依赖，步骤繁琐且容易出错。
• 一条 pip install 命令即可完成下载、依赖解析和安装。
• 配合 requirements.txt，团队成员可以快速复现相同的依赖环境。

pip install requests   # 自动从 PyPI 下载并处理依赖
pip list               # 查看已安装的包
pip freeze > requirements.txt   # 导出依赖文件
pip install -r requirements.txt   # 从依赖文件安装

3. 前置知识 #

• pip 在命令行（终端）中使用，Windows 可用 CMD 或 PowerShell。
• 包（Package）和库（Library）含义相同，安装后通过 import 使用。
• 安装 A 包时可能自动安装 B、C 等依赖包，pip 会帮你处理。
• 推荐用 python -m pip 代替直接输入 pip，确保包装到当前 Python 解释器。

3.1 pip install #

• 在当前 Python 环境中安装 requests 库。requests 是一个常用的 HTTP 库，用于发送网络请求。
• python：调用当前环境中的 Python 解释器。
• -m：让 Python 以模块方式运行后续的脚本（这里是 pip 模块）。
• pip install requests：告诉 pip 安装名为 requests 的第三方库。

# 推荐写法（避免装到错误的 Python 环境）
python -m pip install requests

3.2 upgrade pip #

• 将当前 Python 环境中的 pip 工具升级到最新版本。新版本的 pip 通常包含性能优化、Bug 修复和新功能。
• python -m pip：同上，使用当前 Python 解释器对应的 pip。
• install：安装包（注意：这里安装的是 pip 自身）。
• --upgrade：升级已安装的包到最新版本。
• pip：包名，即升级 pip 工具本身。

python -m pip install --upgrade pip

4. pip 的安装与验证 #

• Python 3.4+ 默认自带 pip，安装 Python 时勾选 Add Python to PATH。
• pip --version 或 python -m pip --version 可验证是否可用。
• 建议定期升级 pip，避免旧版本无法安装新包。
• 遇到 pip 不是内部或外部命令 时，改用 python -m pip。

pip --version
# pip 25.3 from ...\site-packages\pip (python 3.13)

# 升级 pip
python -m pip install --upgrade pip

5. pip 常用命令 #

• 日常最常用四类操作：安装、卸载、升级、查看包信息。
• pip install -r requirements.txt 是团队协作的核心命令，一键安装项目依赖。
• pip freeze > requirements.txt 导出当前环境所有包及精确版本。
• 安装指定版本用 ==，允许最低版本用 >=，生产环境建议锁定精确版本。

# 安装
pip install requests                  # 最新版
pip install django==4.2.0             # 指定版本
pip install numpy>=1.21               # 最低版本
pip install requests pandas numpy     # 多个包
pip install -r requirements.txt       # 从文件安装

# 卸载
pip uninstall requests

# 升级
pip install --upgrade requests        # 简写：pip install -U requests

# 查看
pip list
pip show requests

6. requirements.txt #

• requirements.txt 记录项目依赖，是团队协作和环境复现的关键文件。
• pip freeze > requirements.txt 导出当前环境所有包（含间接依赖），适合快速快照。
• 手动维护时只写项目直接使用的包，文件更简洁。
• 生产环境建议用 == 锁定精确版本，避免不同机器装到不同版本。

# 文件格式示例
Django==4.2.0          # 精确版本
requests>=2.25.1       # 大于等于指定版本
numpy<1.25.0           # 小于指定版本

pip freeze > requirements.txt       # 导出
pip install -r requirements.txt   # 安装

7. 常见问题 #

• 国内访问 PyPI 较慢时，配置国内镜像源是最有效的解决办法。
• 权限错误通常因在系统全局环境安装，改用虚拟环境即可。
• pip install 成功但 import 失败，多半是装到了另一个 Python，用 python -m pip 重装。
• 依赖冲突时优先新建虚拟环境隔离，不要在全局环境中强行解决。

安装慢或超时 — 使用国内镜像：

# 临时使用
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests

Windows 永久配置：在用户目录 C:\Users\你的用户名\pip\ 下创建 pip.ini：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
[install]
trusted-host = pypi.tuna.tsinghua.edu.cn

常用镜像：

• 清华：https://pypi.tuna.tsinghua.edu.cn/simple
• 阿里云：https://mirrors.aliyun.com/pypi/simple/
• 中科大：https://pypi.mirrors.ustc.edu.cn/simple/

8. 总结 #

• pip 是 Python 包管理的核心工具，配合虚拟环境和 requirements.txt 构成标准开发流程。
• 日常只需记住：建环境 → 激活 → pip install → 写代码 → pip freeze → 分享。

8.1 核心概念 #

概念	说明
pip	Python 官方包管理工具
PyPI	Python 官方软件仓库
requirements.txt	项目依赖配置文件

8.2 最常用命令 #

pip --version                              # 检查版本
pip install package_name                   # 安装包
pip install django==4.2.0                  # 安装指定版本
pip install -r requirements.txt            # 从文件安装
pip list                                   # 查看已安装包
pip show package_name                      # 查看包信息
pip uninstall package_name                 # 卸载包
pip freeze > requirements.txt              # 导出依赖
python -m pip install --upgrade pip        # 升级 pip

8.3 最佳实践 #

• 用 requirements.txt 管理并分享依赖
• 生产环境锁定精确版本（==）
• 国内开发配置镜像源加速下载