requests 是 Python 中最著名、最流行的 HTTP 库,它极大地简化了向网页发送请求、获取响应的过程,让开发者无需关心底层的网络细节。

使用 pip(推荐,最常用)
pip 是 Python 的官方包安装工具,绝大多数情况下,你的 Python 环境中都已经包含了 pip。
步骤 1:打开终端(命令行)
你需要打开一个命令行窗口,具体名称取决于你的操作系统:
- Windows: 命令提示符 或 PowerShell。
- macOS: 终端。
- Linux: 终端 或 控制台。
步骤 2:执行安装命令
在终端中,输入以下命令并按回车:
pip install requests
你会看到类似下面的输出,表示正在下载和安装 requests 及其依赖库(如 charset-normalizer, idna, urllib3 等)。

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 4.8 MB/s eta 0:00:00
Collecting idna<4,>=2.5
Downloading idna-3.6-py3-none-any.whl (61 kB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 61.6/61.6 kB 2.3 MB/s eta 0:00:00
Collecting urllib3<3,>=1.21.1
Downloading urllib3-2.1.0-py3-none-any.whl (123 kB)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 123.9/123.9 kB 5.4 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 7.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.6 requests-2.31.0 urllib3-2.1.0
看到 Successfully installed ... 就表示安装成功了!
为 Python 3 安装(推荐)
如果你的电脑上同时安装了 Python 2 和 Python 3,它们的 pip 命令可能会冲突,为了确保 requests 安装给 Python 3 使用,推荐使用 pip3 命令。
在终端中执行:
pip3 install requests
这个命令会明确地将 requests 安装到 Python 3 的环境中。
使用 Python -m pip
这是一种更稳健的方式,可以避免在某些系统上 pip 命令路径可能不正确的问题,它直接调用 Python 解释器来运行 pip 模块。
在终端中执行:
python -m pip install requests
如果你使用的是 Python 3,并且设置了别名,也可以使用:
python3 -m pip install requests
常见问题与解决方案
'pip' is not recognized as an internal or external command... (Windows)
问题:在 Windows 的命令提示符中输入 pip 提示找不到命令。
原因:Python 的 Scripts 目录没有被添加到系统的环境变量 PATH 中。
解决:
- 找到你的 Python 安装路径(
C:\Users\YourUser\AppData\Local\Programs\Python\Python39\)。 - 将该路径下的
Scripts文件夹(C:\Users\YourUser\AppData\Local\Programs\Python\Python39\Scripts)添加到系统的PATH环境变量中。 - 重启命令提示符窗口。
Could not find a version that satisfies the requirement requests (或 No matching distribution found)
问题:pip 提示找不到 requests 的版本。
原因:
- 网络问题:你的网络无法连接到 Python 的官方包仓库 PyPI。
- 代理问题:如果你在公司的网络环境中,可能需要配置代理。
- Python 版本过旧:你的 Python 版本太旧,
pip也太旧,无法理解新的包格式。
解决:
- 检查网络:确保你的网络连接正常。
- 配置代理(如果需要):
pip install requests --proxy http://user:password@proxyaddress:port
- 升级 pip:先尝试升级
pip本身,这通常能解决很多问题。python -m pip install --upgrade pip
Permission denied (macOS / Linux)
问题:在 macOS 或 Linux 上,安装时提示权限被拒绝。 原因:尝试在系统级别的 Python 环境中安装,而你没有管理员权限。 解决:
- 推荐方式:为当前用户安装,无需管理员权限。
pip install requests --user
- 不推荐方式:如果你确实需要为整个系统安装,可以使用
sudo(请谨慎使用)。sudo pip install requests
如何验证安装成功?
安装完成后,你可以通过一个简单的 Python 脚本来验证 requests 是否已经成功安装并且可以正常使用。
创建一个名为 test_requests.py 的文件,内容如下:
import requests
try:
# 尝试向一个可靠的网站发送一个 GET 请求
response = requests.get('https://www.baidu.com', timeout=5)
# 检查请求是否成功 (状态码 200 表示成功)
if response.status_code == 200:
print("成功安装 requests!")
print(f"请求状态码: {response.status_code}")
print(f"响应内容的前 100 个字符: {response.text[:100]}")
else:
print(f"请求失败,状态码: {response.status_code}")
except requests.exceptions.RequestException as e:
print(f"发生错误: {e}")
然后在终端中运行这个脚本:
python test_requests.py
如果一切正常,你会看到类似下面的输出:
成功安装 requests!
请求状态码: 200的前 100 个字符: <!DOCTYPE html>
<!--STATUS OK--><html> <head><meta http-equiv=content-type content=text/html;charset=utf-8><meta
看到这个输出,就证明你已经完全成功安装并可以开始使用 requests 了!
