### VSCode 中安装 Python `requests` 库的方法及常见问题解决 在 VSCode 中安装和使用 Python 的 `requests` 库，核心在于确保命令在正确的 Python 环境下执行，并在 VSCode 中选择与之匹配的解释器。主要流程为：1. 确认并安装 `requests`；2. 在 VSCode 中配置 Python 解释器。 #### 一、核心安装步骤 | 步骤 | 操作命令/位置 | 说明与预期结果 | | :--- | :--- | :--- | | **1. 检查 Python 环境** | 系统终端执行 `python --version` 或 `python3 --version` | 确认系统已安装 Python。若同时存在 Python 2 和 3，应使用 `python3` 和 `pip3` 进行后续操作[ref_3]。 | | **2. 安装 requests 库** | 系统终端执行 `pip install requests` 或 `pip3 install requests` | 使用 pip 包管理器从官方源安装 `requests` 库。若网速慢，可使用国内镜像源加速（如 `pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests`）[ref_2]。 | | **3. 验证安装结果** | 终端执行 `python -c “import requests; print(requests.__version__)`" | 若成功输出版本号（如 `2.31.0`），则表明 `requests` 已正确安装到该 Python 环境。 | | **4. 在 VSCode 中选择解释器** | 点击 VSCode 底部状态栏的 Python 版本信息，或使用命令面板 (`Ctrl+Shift+P`) 输入 “Python: Select Interpreter” | **关键步骤**：从列表中选择与上一步安装 `requests` 时相同的 Python 解释器路径[ref_4]。 | | **5. 在 VSCode 中验证** | 在 .py 文件中输入 `import requests` 并运行 | 若无报错，则表示配置成功。 | #### 二、常见安装问题与解决方案 使用上述步骤时，若仍遇到 `ModuleNotFoundError: No module named ‘requests‘`，通常由以下原因导致： | 问题现象 | 根本原因 | 解决方案 | | :--- | :--- | :--- | | 终端安装成功，但 VSCode 中导入报错 | VSCode 使用的 Python 解释器路径与安装 `requests` 的路径不一致[ref_4]。 | 严格遵循**第四步**，在 VSCode 中选择终端中使用的那个 Python 解释器。 | | 使用虚拟环境时库不显示 | `requests` 被安装在了全局环境，但 VSCode 项目工作在虚拟环境中[ref_5]。 | 1. 在 VSCode 中打开项目文件夹（工作区）。<br>2. 确保解释器已切换为虚拟环境的 Python（通常位于项目下的 `venv` 或 `.venv` 文件夹内）。<br>3. 在 VSCode 集成的终端（该终端会自动激活虚拟环境）中，重新执行 `pip install requests`。 | | `code-runner` 插件运行报错 | `code-runner` 插件默认可能使用了错误的 Python 解释器（如 Python 2.7）[ref_3]。 | 在 VSCode 设置中 (`settings.json`)，为 `code-runner` 指定 Python 3 路径：<br>`“code-runner.executorMap”: { “python”: “/usr/bin/python3” }` (路径需替换为实际的 Python 3 路径)。 | | 网络问题导致安装失败 | 默认 PyPI 源访问慢或不稳定。 | 使用国内镜像源安装，命令如下：<br>`pip install -i https://pypi.tuna.tsinghua.edu.cn/simple requests`[ref_2]。 | #### 三、实践案例与代码验证 以下是一个简单的代码示例，用于验证 `requests` 库是否正常工作，并展示其基本用法。 ```python # 导入 requests 库 import requests # 尝试发送一个 GET 请求到公共测试 API try: response = requests.get('https://httpbin.org/get') # 检查请求是否成功（HTTP 状态码为 200） if response.status_code == 200: print("请求成功！") # 打印响应的部分信息以验证 print(f"状态码: {response.status_code}") print(f"响应头-Content-Type: {response.headers.get('Content-Type')}") # 将 JSON 响应内容解析为字典并打印其中‘url’字段 json_data = response.json() print(f"请求的URL是: {json_data.get('url')}") else: print(f"请求失败，状态码: {response.status_code}") except requests.exceptions.ConnectionError: print("网络连接错误，请检查网络设置。") except Exception as e: print(f"发生未知错误: {e}") ``` **代码说明**： 1. **导入模块**：`import requests`，这是使用该库的前提。 2. **发送请求**：使用 `requests.get()` 方法向 `https://httpbin.org/get` 发送一个 GET 请求。 3. **处理响应**：通过 `response.status_code` 获取 HTTP 状态码，`response.json()` 将 JSON 格式的响应体解析为 Python 字典。 4. **异常处理**：使用 `try...except` 捕获可能出现的网络连接错误或其他异常，使程序更健壮。 运行此脚本，如果看到成功打印出请求的 URL 等信息，则证明 `requests` 库在 VSCode 中已完全配置妥当。 **总结**：在 VSCode 中成功使用 `requests` 库的关键在于**环境一致性**。必须保证在终端中安装库的 Python 环境与 VSCode 当前工作区选择的解释器是同一个。遇到报错时，应首先检查并统一这两处的 Python 路径。对于虚拟环境和 `code-runner` 等插件引起的路径问题，有针对性地调整设置即可解决[ref_3][ref_4][ref_5]。