杰瑞科技汇

Python requests库如何安装?

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

Python requests库如何安装?-图1
(图片来源网络,侵删)

使用 pip(推荐,最常用)

pip 是 Python 的官方包安装工具,绝大多数情况下,你的 Python 环境中都已经包含了 pip

步骤 1:打开终端(命令行)

你需要打开一个命令行窗口,具体名称取决于你的操作系统:

  • Windows: 命令提示符PowerShell
  • macOS: 终端
  • Linux: 终端控制台

步骤 2:执行安装命令

在终端中,输入以下命令并按回车:

pip install requests

你会看到类似下面的输出,表示正在下载和安装 requests 及其依赖库(如 charset-normalizer, idna, urllib3 等)。

Python requests库如何安装?-图2
(图片来源网络,侵删)
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 中。 解决

  1. 找到你的 Python 安装路径(C:\Users\YourUser\AppData\Local\Programs\Python\Python39\)。
  2. 将该路径下的 Scripts 文件夹(C:\Users\YourUser\AppData\Local\Programs\Python\Python39\Scripts)添加到系统的 PATH 环境变量中。
  3. 重启命令提示符窗口。

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 了!

分享:
扫描分享到社交APP
上一篇
下一篇