requests 是一个第三方库,而不是 Python 自带的库,所以它的版本管理非常灵活,你需要明确你想了解的是哪个方面的“版本”:

- 当前最新的稳定版本是什么?
- 如何检查我已安装的
requests版本? - 如何升级或降级
requests到特定版本? requests的版本兼容性如何?
下面我将逐一解答这些问题。
当前最新的稳定版本
你可以通过以下几种方式获取 requests 的最新版本信息:
- 官方网站: https://docs.python-requests.org/ 官方网站通常会显示最新的稳定版本号。
- Python Package Index (PyPI): https://pypi.org/project/requests/ 这是 Python 官方的包仓库,页面上会明确标出最新的稳定版本。
截至我知识更新的最后时间,requests 的最新稳定版本是 requests 2.31.0。版本号会不断更新,请务必通过上述链接查看最新信息。
检查已安装的版本
在你的 Python 环境中,可以通过以下几种方法检查当前安装的 requests 版本:

使用 Python 解释器
在终端或命令行中输入以下命令,然后进入交互式 Python 环境:
python
或者在 Python 虚拟环境中:
python
然后输入以下代码:
import requests print(requests.__version__)
它会直接输出你当前环境中安装的版本号,
28.2

使用 pip show 命令(推荐)
这是最常用和最直接的方法,在终端或命令行中运行:
pip show requests
你会得到类似下面这样的输出,Version 字段就是你要找的版本号:
Name: requests
Version: 2.28.2
Summary: Python HTTP for Humans.
Home-page: https://requests.readthedocs.io
Author: Kenneth Reitz
Author-email: me@kennethreitz.org
License: Apache 2.0
Location: /path/to/your/python/env/lib/python3.9/site-packages
Requires: certifi, charset-normalizer, idna, urllib3
Required-by:
使用 pip list 命令
这个命令会列出所有已安装的包及其版本,你可以在输出中找到 requests。
pip list
输出示例:
Package Version
------------------ ---------
certifi 2025.9.24
charset-normalizer 2.1.1
idna 3.4
pip 22.2.2
requests 2.28.2 <--
setuptools 63.2.0
urllib3 1.26.12
升级或降级 requests 版本
使用 pip 可以轻松地管理 requests 的版本。
升级到最新版本
如果你想升级到最新的稳定版本,运行:
pip install --upgrade requests
升级到特定版本
如果你想升级到某个特定的版本(为了兼容性或测试特定功能),可以指定版本号:
# 升级到 2.31.0 版本 pip install requests==2.31.0
降级到特定版本
降级的方法和升级到特定版本的方法完全一样:
# 降级到 2.25.1 版本 pip install requests==2.25.1
重要提示:强烈建议在虚拟环境中进行包的安装和升级,以避免污染你系统级的 Python 环境。
版本兼容性
requests 库的版本兼容性通常做得很好,但不同版本之间可能存在一些差异,尤其是在处理新特性、Bug 修复和安全漏洞方面。
- 主版本号 (Major, 如
2):requests目前主版本号是2,这意味着它的 API 是向后兼容的,你不需要担心升级到x系列中的任何新版本会破坏你的现有代码。 - 次版本号 (Minor, 如
31): 次版本号的增加通常代表新功能的加入,这些新功能一般是向后兼容的,但了解新版本的变化总是一个好习惯。 - 修订号 (Patch, 如
0): 修订号的增加代表 Bug 修复和安全补丁。强烈建议始终保持你的requests库为最新修订版本,以确保你的应用程序是安全的。
如何查看版本变更?
如果你想了解某个版本具体做了哪些改动,最好的方式是查看其官方发布的 Changelog(变更日志),你可以在 requests 的 GitHub 仓库中找到它:
https://github.com/psf/requests/blob/main/HISTORY.md
你可以清楚地看到从 30.0 到 31.0 都增加了哪些功能,修复了哪些问题。
| 问题 | 解决方案 |
|---|---|
| 最新版本 | 访问 PyPI 或 官方文档 查看。 |
| 检查本地版本 | pip show requests 或在 Python 中 import requests; print(requests.__version__)。 |
| 升级/降级 | pip install --upgrade requests 或 pip install requests==<version_number>。 |
| 兼容性 | API 向后兼容,建议保持最新版本以获得安全和 Bug 修复,查看 HISTORY.md 了解变更。 |
希望这份详细的解答能帮助你完全理解 Python requests 库的版本管理!
