cURL 命令生成器使用指南:HTTP 调试基本功
cURL 是开发者最常用的 HTTP 调试工具。本指南讲清楚常用参数、debug 技巧、与 Postman/HTTPie 的对比。
cURL 是 1996 年诞生的命令行 HTTP 工具,至今仍是开发者必备。本指南讲清楚常用参数、复杂请求构造、本工具如何把可视化表单转成可分享的 curl 命令。
为什么仍然要学 cURL
- 跨平台:macOS / Linux / Windows 都内置或易装
- 可分享:一行命令复制粘贴可重现,比 Postman 截图友好
- CI 友好:Shell 脚本可直接调用
- API 文档标配:几乎所有 API 文档都给 curl 示例
常用参数
-X METHOD指定方法(GET 默认可省)-H "Header: Value"添加请求头(可重复)-d "data"POST 请求体--data-raw "data"不转义直接发送(如 JSON)-i显示响应头-v详细模式-o file保存到文件-L自动跟随重定向-k跳过 HTTPS 证书验证(仅调试用!)
常见场景速查
GET with auth:
curl -H "Authorization: Bearer xxx" https://api.example.com/me
POST JSON:
curl -X POST -H "Content-Type: application/json" --data-raw '{"name":"Alice"}' https://api.example.com/users
上传文件:
curl -F "file=@/path/to/file.png" https://api.example.com/upload
cURL vs Postman vs HTTPie
- cURL:命令行、极致灵活、所有 API 文档都给
- Postman:图形界面、团队协作、收藏请求、自动化测试
- HTTPie:人类友好的 cURL(彩色输出、JSON 高亮)
实际开发:日常用 Postman 调试,调试别人服务器/写脚本时用 cURL,本地玩用 HTTPie。
本工具的工作流
- 在表单里选方法、填 URL、加 headers、写 body
- 右下方实时显示对应的 cURL 命令
- 复制粘贴到终端测试,或贴给同事
- 想反向:粘贴 cURL 命令到 Postman 也能 import
常见问题
curl 在 Windows 上能用吗?
Windows 10+ 内置(PowerShell 也可用)。注意 Windows 终端用单引号会出问题,建议用双引号或 Git Bash。
怎么测试 WebSocket?
curl 不行,用 wscat 或 websocat。
能保存 cookie 吗?
可以。`-c cookies.txt` 保存、`-b cookies.txt` 读取。