pip（Python Package Installer）是 Python 官方推荐的包管理工具，主要用于安装、升级、卸载和管理 Python 第三方库和依赖项。pip 直接与 Python Package Index（PyPI） 交互，同时支持自定义软件源，并可与 venv、virtualenv 结合使用。

---

1. pip 下载安装与升级

1.1 检查 pip 版本

在终端或命令行输入：

pip --version

示例输出：

pip 23.0.1 from /usr/local/lib/python3.9/site-packages/pip (python 3.9)

1.2 安装 pip

Linux/macOS

默认 Python 3 以上版本自带 pip，如果缺失，可使用：

python3 -m ensurepip --default-pip

或者下载官方安装脚本：

curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3 get-pip.py

Windows

python -m ensurepip --default-pip

若仍不可用，可尝试：

python -m pip install --upgrade pip

1.3 升级 pip

保持 pip 版本最新，以获得最佳兼容性：

pip install --upgrade pip

---

2. pip 基本用法

2.1 安装 Python 包

pip install package_name

示例：

pip install requests

指定版本安装

pip install package_name==1.2.3

例如：

pip install flask==2.2.2

安装多个包

可以使用 requirements.txt 管理依赖项：

flask==2.2.2
requests>=2.26.0
numpy

安装方式：

pip install -r requirements.txt

---

2.2 卸载 Python 包

pip uninstall package_name

示例：

pip uninstall numpy

---

2.3 查看已安装的包

pip list

示例输出：

Package    Version
---------- -------
Flask      2.2.2
requests   2.26.0

2.4 查看包详细信息

pip show package_name

例如：

pip show requests

示例输出：

Name: requests
Version: 2.26.0
Summary: Python HTTP for Humans.
Home-page: https://requests.readthedocs.io/en/latest/
Location: /usr/local/lib/python3.9/site-packages
Requires: certifi, urllib3, charset-normalizer, idna

2.5 检查可用更新

pip list --outdated

示例输出：

Package    Version Latest Type
---------- ------- ------ -----
Flask      2.2.2   2.3.0  wheel
requests   2.26.0  2.27.1 wheel

如果需要更新：

pip install --upgrade flask requests

---

3. 使用国内镜像加速 pip 下载

3.1 临时使用

pip install package_name -i https://pypi.tuna.tsinghua.edu.cn/simple

示例：

pip install pandas -i https://pypi.tuna.tsinghua.edu.cn/simple

3.2 配置全局镜像

在 ~/.pip/pip.conf（Linux/macOS）或 C:\Users\你的用户名\pip\pip.ini（Windows）中添加：

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

国内常用 PyPI 镜像：

镜像源	地址
清华大学	https://pypi.tuna.tsinghua.edu.cn/simple
阿里云	https://mirrors.aliyun.com/pypi/simple/
豆瓣	https://pypi.douban.com/simple/
华为	https://repo.huaweicloud.com/repository/pypi/simple/

---

4. pip 进阶用法

4.1 生成 requirements.txt

导出当前环境的依赖：

pip freeze > requirements.txt

示例：

flask==2.2.2
requests==2.26.0
numpy==1.21.2

4.2 依赖项检查

检测包依赖是否存在问题：

pip check

4.3 查看 pip 配置

pip config list

4.4 清理 pip 缓存

pip cache purge

---

5. pip 解决常见问题

5.1 pip 命令未找到

pip: command not found

解决方案：

python3 -m ensurepip --default-pip
python3 -m pip install --upgrade pip

5.2 SSL 证书错误

错误信息：

pip is configured with locations that require TLS/SSL, however the ssl module in Python is not available.

解决方案：

• 重新安装 OpenSSL：

  sudo apt install openssl

• 重新编译 Python 并启用 SSL 支持：

  ./configure --with-openssl

5.3 依赖冲突

pip check

如果有冲突：

pip install package_name --force-reinstall

---

6. pip 与虚拟环境（venv）

推荐在虚拟环境中安装依赖，以避免全局 Python 依赖冲突：

python3 -m venv myenv
source myenv/bin/activate  # Linux/macOS
myenv\Scripts\activate     # Windows
pip install flask

退出虚拟环境：

deactivate

---

7. 总结

命令	作用
pip install package_name	安装包
pip uninstall package_name	卸载包
pip list	查看已安装包
pip show package_name	查看包详情
pip freeze > requirements.txt	导出依赖
pip install -r requirements.txt	依赖安装
pip check	检查依赖
pip list --outdated	检查可升级的包
pip install --upgrade pip	升级 pip

pip 是 Python 生态中至关重要的工具，掌握它可以大幅提升 Python 开发效率。