Python pip 包管理工具使用指南

# 安装 .whl 包（需匹配 Python 版本/系统架构）
python -m pip install requests-2.28.1-py3-none-any.whl
# 安装源码包
python -m pip install requests-2.28.1.tar.gz

（5）批量安装（requirements.txt）

requirements.txt 是项目依赖清单，格式为「包名==版本号」，适合团队协作：

# requirements.txt 示例
requests==2.28.1
numpy==1.24.3
pandas==2.0.1

执行批量安装：

python -m pip install -r requirements.txt

2. 查看已安装的包

# 查看所有已安装包（含版本）
python -m pip list
# 查看指定包的详细信息（版本、依赖、安装路径）
python -m pip show requests

3. 更新包

# 更新指定包到最新版本
python -m pip install --upgrade requests
# 简写
python -m pip install -U requests

4. 卸载包

# 卸载单个包（需确认）
python -m pip uninstall requests
# 卸载多个包（跳过确认提示）
python -m pip uninstall -y numpy pandas

三、pip 进阶技巧（避坑 + 效率）

1. 更换国内镜像源（解决下载慢/失败）

默认 pip 从国外 PyPI 源下载，速度慢，优先配置国内镜像。

（1）临时使用（单次生效）

python -m pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple/

（2）永久配置（推荐）

配置内容（通用）：

[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.douban.com/simple/

2. 导出项目依赖（方便部署）

# 导出所有已安装包到 requirements.txt
python -m pip freeze > requirements.txt
# 仅导出项目实际用到的包（更精准，需先装 pipreqs）
python -m pip install pipreqs
pipreqs ./ --encoding=utf8
# ./ 为项目目录

3. 解决权限问题（安装报错 Permission denied）

# 安装到用户目录（不影响系统级 Python）
python -m pip install requests --user

4. 忽略缓存强制重新下载

python -m pip install requests --no-cache-dir

5. 检查包依赖冲突

python -m pip check

6. 升级 pip 自身

# Windows
python -m pip install --upgrade pip
# macOS/Linux（避免系统权限问题）
python -m pip install --upgrade pip --user

四、Windows 特有的 pip 避坑指南

五、验证 pip 操作结果

以 requests 为例，验证安装/版本是否符合要求：

# 进入 Python 交互环境
import requests
print("requests 版本：", requests.__version__)
# 输出 2.28.1 即符合 >=2.20,<3.0
response = requests.get("https://www.baidu.com")
print("请求状态码：", response.status_code)
# 输出 200 表示包可用

总结

1. 核心避坑：Windows CMD 中执行含 </> 的版本范围命令时，必须给版本加引号；
2. 通用写法：优先使用 python -m pip 替代直接 pip，避免环境变量冲突；
3. 效率优化：配置国内镜像源，解决包下载慢/失败问题；
4. 版本管理：通过 == 指定精确版本，通过 ">=x.x,<x.x" 指定版本范围（Windows 加引号）。

掌握以上内容，即可熟练、无坑地使用 pip 管理 Python 第三方包，满足日常开发、部署的所有需求。