Python 转换 cURL 完全指南：开发者实用手册

在终端中测试 API、下载文件或发送 HTTP 请求时，cURL 是最快捷的方式之一。不过，当任务需要循环、可复用逻辑、定时调度或错误处理时，终端命令就显得不够方便了。

正因如此，开发者常常将 cURL 转换为 Python 代码，并改用 Requests 库。本指南将介绍如何转换 cURL 命令、翻译常见选项、处理身份验证与文件上传，以及使用自动转换工具。

什么是 cURL？

cURL 是一种用于通过 URL 传输数据的命令行工具，支持 HTTP、HTTPS、FTP 等多种协议，开发者通常用它来调试 API、传输文件以及快速测试端点。

cURL 命令简洁，适合一次性运行。而当同一个请求需要成为应用程序或自动化脚本的一部分时，Python 请求通常更便于维护。将命令迁移到 Python 后，您可以在请求周围添加条件判断、循环、日志记录、重试机制、解析逻辑等程序控制逻辑。

特性

cURL

Python requests

语法

终端命令

Python 代码

易用性

适合快速测试

更适合编写可复用脚本

请求头与数据

使用 -H、-d 等参数

字典与函数参数

自动化

Shell 脚本与定时任务

完整的 Python 生态系统

错误处理

退出码与 Shell 逻辑

异常与响应方法

理解 cURL 命令

大多数 cURL 命令遵循以下简单结构：

curl [options] URL

常见选项包括：

-X 用于指定方法，如 GET、POST、PUT 或 DELETE

-H 或 --header 用于添加请求头

-d 或 --data 用于发送请求数据

-u 用于提供用户名和密码

-i 用于在输出中包含响应头

一个基本的 GET 请求如下所示：

curl "https://api.example.com/users?page=2"

一个带有请求头和请求体的 POST 请求可能如下所示：

curl -X POST "https://api.example.com/users" \
 
-H "Content-Type: application/json" \
 
-d '{"name":"Alex"}'

理解每个标志控制哪个部分，能让将 cURL 命令转换为 Python 代码变得容易得多。URL 标识端点，而各个选项则定义了方法、请求头、凭据和请求体。

在将命令翻译为 Python 之前，先在脑海中把这些部分区分开来。这个简单的习惯能让较长的终端示例不再让人望而生畏。

如何手动将 cURL 转换为 Python

手动转换很有价值，因为它能帮助您理解 Python cURL 命令各部分是如何组合在一起的。一个好的做法是每次只转换一个选项。当自动转换工具生成的结果不符合预期时，这种方法也很有帮助。

一旦您能自行将常见命令映射为 Python 代码，调试生成的代码片段就会快得多。

转换 GET 请求

要转换一个简单的 GET 请求，只需导入 Requests 并调用 requests.get()：

import requests
 
 
params = {"page": 2}
 
headers = {"Accept": "application/json"}
 
 
r = requests.get(
 
    "https://api.example.com/users",
 
    params=params,
 
    headers=headers,
 
    timeout=10
 
)
 
 
print(r.status_code)

查询参数放入 params 中，cURL 的 -H 值则变为 headers 字典中的条目。这是将命令翻译为 Python 代码最简单的方式之一，也能让最终的 URL 保持清晰易读。

对于更复杂的 GET 请求，您可以持续向 params 中添加键值对，而无需手动拼接冗长的查询字符串。

转换 POST 请求

在转换发送表单字段的 cURL 命令时，使用 data 参数：

r = requests.post( "https://api.example.com/login", data={"username": "alex", "password": "secret"} )

对于 json 数据，则改用 json=：

payload = {"name": "Alex"}
 
 
r = requests.post(
 
    "https://api.example.com/users",
 
    json=payload,
 
    timeout=10
 
)

这比手动序列化请求体并自行设置 JSON 内容类型要简洁得多。在将 POST 命令迁移到 Python 时，需先确认原始请求体是表单编码还是 JSON 格式，再决定使用 data= 还是 json=。

身份验证方法

cURL 的 -u 标志通常对应 HTTP 基本身份验证：

import requests
 
from requests.auth import HTTPBasicAuth
 
 
r = requests.get(
 
    "https://api.example.com/account",
 
    auth=HTTPBasicAuth("user", "password")
 
)

对于 Bearer 令牌，需将 cURL 的身份验证请求头转换为普通的 Python 字典：

headers = {"Authorization": "Bearer YOUR_TOKEN"}
 
r = requests.get("https://api.example.com/data", headers=headers)

这使得身份验证信息在多个 Python 请求之间更易于复用。

处理文件上传

对于 multipart 上传，Requests 接受 files 参数：

with open("report.pdf", "rb") as file:
 
   response = requests.post(
 
        "https://api.example.com/upload",
 
        files={"file": file}
 
    )

需要注意的是，cURL 的 --upload-file 与 multipart 表单上传不同。在 HTTP(S) 场景下，它通常使用 PUT 方法执行上传。更贴近的 Python 等效写法是：

with open("report.pdf", "rb") as file:
 
    response = requests.put(
 
        "https://api.example.com/report.pdf",
 
        data=file
 
    )

了解这一区别可以避免 Python cURL 命令在不知不觉中改变请求格式。

SSL 证书与错误处理

cURL 的 -k 会禁用证书验证。Requests 中最接近的选项是 verify=False，但只有在您充分理解其中的安全风险时才应使用。

import requests
 
 
try:
 
    response = requests.get(
 
        "https://api.example.com/data",
 
        timeout=10,
 
        verify=True
 
    )
 
    response.raise_for_status()
 
except requests.exceptions.RequestException as exc:
 
    print(f"Request failed: {exc}")

超时与异常处理是将 cURL 转换为脚本的重要原因之一。Python requests 能让您清晰地掌控失败情况，而不必将错误处理完全交给 Shell 逻辑。

实际使用场景

调用 API（真实案例）

假设有一个带有 Bearer 令牌、自定义请求头和 JSON 请求体的 API 调用：

curl -X POST "https://api.example.com/tasks" \
 
 -H "Authorization: Bearer YOUR_TOKEN" \
 
 -H "Content-Type: application/json" \
 
 -d '{"title":"Check prices","active":true}'

可以将 cURL 转换为如下代码：

import requests
 
 
url = "https://api.example.com/tasks"
 
headers = {"Authorization": "Bearer YOUR_TOKEN"}
 
payload = {"title": "Check prices", "active": True}
 
 
response = requests.post(url, headers=headers, json=payload, timeout=10)
 
response.raise_for_status()
 
 
print(response.json())

Python 代码更长，但更易于扩展。您可以验证响应、保存结果、添加代理设置，或对多条记录重复发送该请求。

实现 HTTP 请求自动化

一次性的终端命令固然方便，但重复性工作正是命令转换为 Python 代码更有价值的地方。脚本可以从文件中读取输入、发送数百个 Python 请求、处理每个响应，并将结果写入数据库。

随后，您可以在 Linux 或 macOS 上通过 cron 运行该脚本，在 Windows 上使用任务计划程序，或借助编排平台运行。这也是开发者从测试阶段转向生产自动化时，常常需要转换 cURL 命令的原因之一。

自动化的 cURL 转 Python 工具

在线转换工具

当您需要快速转换 cURL 命令时，cURL Converter 是一个便捷的选择。将命令粘贴到输入框中，按需选择 Python，然后复制生成的 Python 代码即可。它同样支持粘贴从浏览器开发者工具中复制的命令。

一个简单的使用流程是：

复制 cURL 命令
粘贴到 cURL Converter 中
检查生成的 Python cURL 命令
核对请求头、Cookie、请求体和重定向情况
在投入生产环境前先测试代码

转换工具能节省时间，但请务必检查输出结果。默认行为上的差异可能带来影响，尤其是在重定向、Cookie 和不常见的 cURL 选项方面。

Python 库

uncurl 是一个专为将 cURL 请求转换为 Python Requests 语法而设计的 Python 包，可通过以下方式安装：

pip install uncurl

然后在 Python 中使用：

import uncurl
 
command = "curl https://example.com -H 'Accept: application/json'"
print(uncurl.parse(command))

当您需要在 Python 工作流中转换 cURL 命令时，这个包会很有用。不过，该包自 2021 年以来未在 PyPI 上发布新版本，因此请仔细测试生成的代码，如需更广泛且持续维护的转换支持，可考虑使用 cURL Converter。

结语

学习将 cURL 转换为 Python，本质上就是将命令行选项翻译为 Requests 参数：请求头对应字典，查询字符串对应 params，请求体对应 data 或 json，身份验证则对应 headers 或 auth。

先从自行掌握转换逻辑开始，逐条命令地将 cURL 转换为 Python 代码。等您熟练掌握这种转换方式后，再借助自动化工具加快重复性工作，而不会让整个过程变成一个看不透的黑箱。

不妨亲自动手尝试一些 cURL 命令，比如 GET、POST、身份验证、文件上传和错误处理，最后再参考 cURL 与 requests 的官方文档。