读懂 cURL 命令

cURL 命令既是 HTTP 请求，也是 shell 命令。转换之前，先把这两层分开。

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

HTTP 请求包含：

• 方法：POST
• URL：https://api.example.com/users
• Headers：Authorization、Content-Type
• 请求体：{"name":"Ada"}

Shell 层包含引号、换行续写和转义规则。

URL 的位置

URL 可能出现在末尾、开头附近，或出现在 --url 后：

curl --url "https://api.example.com/search?q=json"

转换器应该识别真正的请求 URL，而不是假设最后一个 token 一定是 URL。

引号很重要

单引号、双引号和反斜杠会先被 shell 解释，然后 cURL 才收到参数。文档中的命令可能面向 Bash、zsh、PowerShell 或 CMD。转换时应保留 HTTP 值的意图，而不是把引号字符本身当作请求内容。

Body 标志会改变默认方法

当 cURL 看到 -d 时，请求通常会变成 POST，除非另行指定方法。这会让以为自己在发 GET 的开发者感到意外。

读命令时先按 shell 语法读一遍，再按 HTTP 请求读一遍。不要把两层混在一起，转换才更安全。