pip install requests失败主因是环境或权限问题,常见于path未配置,应优先用python -m pip install requests;安装慢可加-i参数换清华源;验证需导入测试或发请求确认。

pip install requests 命令执行失败的常见原因
直接运行 pip install requests 报错,大概率不是 requests 本身的问题,而是环境或权限链路断了。最常遇到的是:'pip' 不是内部或外部命令,说明系统没找到 pip 可执行文件——根本原因是 Python 安装时没勾选 Add Python to PATH,或者你用的是非标准安装路径(比如通过 Microsoft Store 装的 Python)。此时别急着重装,先试 python -m pip install requests,这个写法强制调用当前 Python 解释器自带的 pip 模块,绕过 PATH 依赖。
Windows/macOS/Linux 下推荐的安装命令组合
不同系统、不同 Python 环境下,命令要匹配实际场景:
- 通用兜底写法(所有系统都适用):
python -m pip install requests - 确认 pip 已就位后,可简化为:
pip install requests - 若系统同时装了 Python 2 和 Python 3,且默认
python指向 Python 2:python3 -m pip install requests或pip3 install requests - 在虚拟环境中(强烈建议):先激活环境(如
source venv/bin/activate或venv\Scripts\activate),再运行pip install requests—— 这样不会污染全局包
安装慢或超时?换源是最快解法
PyPI 官方源在国内访问不稳定,pip install requests 卡住或报 ReadTimeoutError 很常见。不用改配置文件,单次安装加 -i 参数即可切换镜像源:
清华源(推荐):pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple
调用百度文档解析API,支持18+格式,提取文本、表格、版面分析、OCR识别及RAG文档分块。适用于文档解析、文本/表格提取、结构分析、扫描件处理。触发词:文档解析、PDF解析、Word解析、表格提取、OCR、文档分析、提取文本、文档结构、扫描识别。
中科大源:pip install requests -i https://pypi.mirrors.ustc.edu.cn/simple
注意:simple 结尾不能漏,否则会 404;也不要用带 / 结尾的错误写法,如 https://pypi.tuna.tsinghua.edu.cn/simple/。
验证是否真装上了,别只看“Successfully installed”
终端显示安装成功不代表能用。真正有效的验证方式只有两种:
- 在 Python 交互式环境里导入并查版本:
python -c "import requests; print(requests.__version__)" - 发个最小请求测试连通性:
python -c "import requests; print(requests.get('https://httpbin.org/get').status_code)"—— 返回200才算闭环
如果报 ModuleNotFoundError: No module named 'requests',说明你验证时用的 Python 解释器跟安装时不是同一个(比如 VS Code 默认用了系统 Python,而你是在虚拟环境里装的)——这时得检查 which python 或 where python,再对齐环境。










