Requests - 环境设置

Requests: 设置 Python 开发环境

在使用 requests 库发起 HTTP 请求之前，你需要先安装 Python，然后安装 requests 包本身。本章将引导你完成设置过程，重点介绍使用虚拟环境 (virtual environments) 等现代最佳实践。

确保 Python 已安装
理解和使用虚拟环境
安装 requests 库

1. 确保 Python 已安装

requests 库是一个 Python 包，因此 Python 是先决条件。大多数现代操作系统 (Linux 和 macOS) 都预装了 Python。对于 Windows 系统，或者如果你需要特定版本的 Python，则需要自行安装。

下载和安装 Python

访问 Python 官方网站：https://www.python.org/downloads/。下载适合你操作系统 (Windows, macOS, Linux/UNIX) 的最新稳定版本。

在安装过程中（尤其是在 Windows 上），请务必勾选类似“Add Python to PATH”或“Add python.exe to Path”的选项。这使得 Python 及其包管理器 pip 可以通过你的命令行或终端访问。

验证 Python 安装

打开你的终端或命令提示符，输入以下命令来检查 Python 和 pip 是否已正确安装并配置到 PATH 中：

python --version
# 或在某些系统上
python3 --version

这应该会打印出已安装的 Python 版本（例如，Python 3.11.4）。

pip --version
# 或者
pip3 --version

这应该会打印出 pip 的版本及其安装位置。

如果这些命令不起作用，你可能需要排除 Python 安装或 PATH 配置的问题。请参阅 Python 官方文档寻求帮助。

2. 理解和使用虚拟环境

在安装 requests 或任何其他 Python 包之前，强烈建议创建一个虚拟环境。虚拟环境是一个独立的 Python 设置，允许你单独管理特定项目的依赖项，从而防止需要不同版本同一库的项目之间发生冲突。

创建虚拟环境

Python 3 自带 venv 模块用于创建虚拟环境。在终端中导航到你的项目目录并运行：

# 将 'myproject_env' 替换为你想要的环境名称
python -m venv myproject_env
# 或在某些系统上
python3 -m venv myproject_env

此命令会创建一个新文件夹（例如 myproject_env），其中包含一个全新的 Python 安装和专门用于此环境的 pip。

激活虚拟环境

在使用虚拟环境之前，你需要先激活它：

在 Windows 上 (命令提示符/PowerShell)：

.\myproject_env\Scripts\activate

在 macOS 和 Linux 上 (bash/zsh)：

source myproject_env/bin/activate

激活后，你的终端提示符通常会改变以指示当前活动的环境（例如 (myproject_env) Your-Computer:your_project user$）。现在，你使用 pip 安装的任何包都将安装在此独立的虚拟环境中。

3. 安装 `requests` 库

激活虚拟环境后，你现在可以使用 pip 安装 requests 库了：

pip install requests

pip 会从 Python 包索引 (PyPI) 下载 requests 及其依赖项（如 certifi、charset-normalizer、idna、urllib3），并将它们安装到你当前激活的虚拟环境中。

验证 `requests` 安装

你可以通过 pip show 命令检查 requests 的版本来验证其是否正确安装：

pip show requests

输出（示例）

Name: requests
Version: 2.31.0  # 版本号可能不同
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/project/myproject_env/lib/pythonX.Y/site-packages
Requires: certifi, charset-normalizer, idna, urllib3
Required-by:

你也可以在 Python 解释器中尝试导入它：

python
>>> import requests
>>> print(requests.__version__)
# 预期输出：版本字符串，例如 '2.31.0'

停用虚拟环境

当你完成项目工作后，只需输入以下命令即可停用虚拟环境：

deactivate

此命令适用于所有操作系统。

使用 `requirements.txt` 管理依赖项

随着你向项目添加更多包，将它们记录在 requirements.txt 文件中是一个好习惯。你可以使用以下命令生成此文件：

pip freeze > requirements.txt

其他人（或你未来的自己）可以使用 pip install -r requirements.txt 命令轻松地根据此文件安装项目所需的所有依赖项。