下面我将为您提供几种安装方法,并附上详细的步骤和常见问题解答。
使用 pip (最常用、最推荐)
pip 是 Python 的官方包管理工具，通常随 Python 一起安装，这是安装 requests 最标准的方法。
步骤 1: 打开终端/命令行
您需要打开一个命令行窗口,具体取决于您的操作系统：
- Windows: 在开始菜单中搜索
cmd或PowerShell，然后打开。 - macOS: 在“应用程序” > “实用工具” 中找到“终端”(Terminal)。
- Linux: 按
Ctrl + Alt + T快捷键，或者在应用程序菜单中找到“终端”。
步骤 2: 检查 pip 是否已安装
在终端中输入以下命令,如果能看到 pip 的版本号，说明已安装。
pip3 --version
或者,在某些系统上，可能直接使用 pip：
pip --version
注意： 强烈建议使用 pip3，因为它明确指向 Python 3 的包管理器，避免与 Python 2 的 pip 混淆（如果您系统上同时存在 Python 2 和 3）。
如果提示 pip 不是内部或外部命令，说明 pip 可能没有添加到系统的环境变量中，您可以尝试升级一下 pip，这个过程有时也能修复问题（见下一步）。
步骤 3: 升级 pip (推荐)
为了确保使用的是最新、最安全的 pip 版本，建议先执行升级命令：
python3 -m pip install --upgrade pip
或者：
pip3 install --upgrade pip
步骤 4: 安装 requests
执行以下命令来安装 requests 库：
pip3 install requests
或者：
pip install requests
您会看到类似下面的输出,表示正在下载和安装：
Collecting requests
Downloading requests-2.31.0-py3-none-any.whl (62 kB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 62.6/62.6 kB 1.1 MB/s eta 0:00:00
Collecting charset-normalizer<4,>=2
Downloading charset_normalizer-3.3.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2025_x86_64.whl (141 kB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 141.8/141.8 kB 5.9 MB/s eta 0:00:00
Collecting idna<4,>=2.5
Downloading idna-3.4-py3-none-any.whl (61 kB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 61.5/61.5 kB 3.1 MB/s eta 0:00:00
Collecting urllib3<3,>=1.21.1
Downloading urllib3-2.0.6-py3-none-any.whl (123 kB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 123.9/123.9 kB 6.3 MB/s eta 0:00:00
Collecting certifi>=2025.4.17
Downloading certifi-2025.7.22-py3-none-any.whl (158 kB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 158.3/158.3 kB 8.0 MB/s eta 0:00:00
Installing collected packages: urllib3, idna, charset-normalizer, certifi, requests
Successfully installed certifi-2025.7.22 charset-normalizer-3.3.0 idna-3.4 requests-2.31.0 urllib3-2.0.6看到 Successfully installed ... requests 就表示安装成功了！
使用 Python 的 -m 选项
这种方法在某些环境下（系统环境变量配置不正确时）更加可靠，它直接调用 Python 解释器来运行 pip 模块。
python3 -m pip install requests
如何验证安装是否成功？
安装完成后,最好的验证方式就是在 Python 交互式环境中尝试导入它。
- 在终端中输入
python3并回车，进入 Python 交互式环境。 - 然后输入
import requests并回车。 - 如果没有任何错误提示（
ModuleNotFoundError），并且光标正常出现在下一行，就说明安装成功了！
$ python3 Python 3.10.12 (main, Nov 20 2025, 15:14:05) [GCC 11.4.0] on linux Type "help", "copyright", "credits" or "license" for more information. >>> import requests >>> >>> # 你还可以查看一下它的版本号 >>> requests.__version__ '2.31.0' >>> >>> # 输入 exit() 退出 Python 环境 >>> exit()
常见问题与解决方案 (FAQ)
Q1: pip 命令未找到，该怎么办？
-
Windows:
- 确保您在安装 Python 时勾选了 "Add Python to PATH" 选项。
- 如果没有,您可以手动将 Python 的
Scripts目录（C:\Python39\Scripts）和根目录（C:\Python39）添加到系统的环境变量Path中。 - 或者,直接使用
py命令：py -m pip install requests。py是 Python 启动器，能自动找到正确的 Python 版本。
-
macOS / Linux:
- 确保您已经安装了 Python 3，通常系统会自带。
- 检查
pip是否在正确的路径下，您可能需要使用sudo权限来安装（不推荐，但有时是唯一方法）：sudo pip3 install requests
- 更好的做法是使用
python3 -m pip，如上所述。
Q2: 权限错误 (Permission Denied)
在 macOS 或 Linux 上，您可能会看到 Permission denied 错误，这是因为您没有足够的权限写入系统级的 Python 包目录。
解决方案：
-
推荐：为当前用户安装（不需要管理员权限）
pip3 install --user requests
这会将包安装到您用户主目录下的一个本地文件夹中（
~/.local/lib/python3.x/site-packages）。 -
不推荐：使用
sudosudo pip3 install requests
这需要您输入管理员密码,使用
sudo可能会导致系统 Python 环境混乱，应尽量避免。
Q3: "Could not find a version that satisfies the requirement requests" 错误
这通常意味着您的 pip 版本太旧，无法从 PyPI（Python 包索引）下载新版本的包。最简单的解决方案就是升级 pip。
python3 -m pip install --upgrade pip
升级完成后,再重新尝试安装 requests。
对于绝大多数用户,最简单、最可靠的安装流程是：
- 打开终端 (Terminal / Command Prompt)。
- 运行升级命令：
python3 -m pip install --upgrade pip - 运行安装命令：
python3 -m pip install requests - 验证安装：
python3->import requests->exit()
祝您编码愉快！
