Python pip 包管理工具

Begindev 编辑部 March 25, 2026

在 Python 编程的世界里，想要超越内置功能的限制，通常需要借助外部包（Packages）。这些由 Python 社区开发和维护的包提供了预先编写好的代码和工具，可以帮你完成特定任务，从而节省大量的时间和精力。

pip（代表 "Pip Installs Packages" 或 "Pip Installs Python"）是 Python 的标准包安装程序。它允许你极其轻松地从 Python 包索引（PyPI - Python Package Index）中下载、安装和管理这些外部包。

1. 理解 pip 和 PyPI

pip 是一个命令行工具，它充当着与 PyPI 交互的桥梁。你可以把 PyPI 想象成 Python 库的“应用商店”。当你使用 pip 安装一个包时，它会在 PyPI 中搜索指定的包，将其下载并安装到你的 Python 环境中。

1.1 PyPI 的作用

PyPI（Python Package Index）是 Python 包的中央仓库。它托管了海量的开源库和工具，开发者可以在自己的项目中免费使用它们。PyPI 确保了所有的包都能随时被获取，并通过 pip 轻松访问。

1.2 为什么使用 pip？

简单易用： pip 通过其直观的命令行界面，极大地简化了安装和管理外部包的过程。
依赖管理： pip 会自动处理包的依赖关系，确保所有必需的底层库都被正确安装。
版本控制： pip 允许你指定安装包的版本，从而保证项目的兼容性和可重复构建。
广泛普及：大多数 Python 安装包中都已经内置了 pip，开箱即用。

2. 使用 pip 安装包

pip 最常见的用途就是安装包。打开你的命令提示符（Windows）或终端（Mac/Linux），输入以下命令：

pip install <包名>

请将 <包名> 替换为你想要安装的实际包的名称。例如，要安装用于发起 HTTP 请求的流行库 requests，你需要使用：

pip install requests

随后，pip 会自动下载并安装 requests 包及其所需的任何依赖项。

2.1 指定包版本

有时，出于兼容性考虑，你可能需要某个包的特定版本。你可以使用 == 运算符来指定版本号：

pip install requests==2.26.0

这将会安装 requests 包的 2.26.0 版本。你也可以使用其他比较运算符，如 >=、<=、> 和 < 来指定一个版本范围。

2.2 升级包

要将已安装的包升级到最新版本，请使用 --upgrade 标志：

pip install --upgrade <包名>

例如，升级 requests 包：

pip install --upgrade requests

2.3 卸载包

要卸载一个包，请使用 uninstall 命令：

pip uninstall <包名>

例如，卸载 requests 包：

pip uninstall requests

执行后，pip 会提示你确认是否卸载。

3. 使用 Requirements 文件管理依赖

对于较大的项目，通常的做法是使用一个名为 requirements.txt 的文件来声明项目的所有依赖项。这个文件列出了项目正常运行所需的所有包及其精确版本。

3.1 创建 requirements.txt 文件

你可以手动创建 requirements.txt 文件，也可以使用 pip 自动生成一个：

pip freeze > requirements.txt

这条命令会列出你当前环境中所有已安装的包，并将它们保存到 requirements.txt 文件中。文件中的每一行都代表一个包及其版本，例如：

requests==2.26.0
urllib3==1.26.7
certifi==2021.10.8
idna==3.3

3.2 从 requirements.txt 安装

要一次性安装 requirements.txt 文件中列出的所有包，请使用以下命令：

pip install -r requirements.txt

这将会安装所有的包及其指定的版本，确保你的项目拥有所有必要的依赖环境。

3.3 综合实战：使用 requests 与 requirements.txt

假设你正在编写一个简单的脚本，使用 requests 库从网站抓取数据。

步骤 1：创建 requirements.txt 文件
首先，确保你已经安装了 requests，然后生成 requirements.txt 文件：

pip install requests
pip freeze > requirements.txt

步骤 2：创建 Python 脚本 (例如 fetch_data.py)

# fetch_data.py
import requests

def fetch_data(url):
    """使用 requests 库从给定的 URL 获取数据。"""
    try:
        response = requests.get(url)
        response.raise_for_status()  # 如果响应状态码错误（4xx 或 5xx），则引发 HTTPError
        return response.text
    except requests.exceptions.RequestException as e:
        print(f"获取数据时出错: {e}")
        return None

if __name__ == "__main__":
    url = "https://www.example.com" # 你可以替换为任何 URL
    data = fetch_data(url)
    if data:
        print("数据获取成功！")
        # print(data) # 取消注释以打印获取到的数据
    else:
        print("数据获取失败。")

步骤 3：运行脚本

python fetch_data.py

如果你的环境中没有安装 requests，程序会报错。请确保使用 pip install -r requirements.txt 或 pip install requests 安装了该库。

这个例子展示了使用 pip 和 requirements.txt 管理依赖的典型工作流程。它确保了任何参与该项目的人都能轻松地配置出具有正确包版本的开发环境。