Curl完全指南:从基础语法到高级实战技巧
说实话,curl这个工具,很多人都在用,但真正把它用明白的人并不多。工作里最常见的场景就是“接口报错了,你 curl 一下看看”,然后大家 curl 一下返回个 JSON,能看出个大概就算完事。但再往后呢?带 Cookie 的登录态怎么模拟?文件上传怎么传?批量请求怎么做?超时重试怎么配?这些一旦要正经用起来,很多人就开始现查现试了。
这篇文章我想系统性地把 curl 拆开讲一遍,从最基础的 URL 请求开始,一路讲到调试、认证、Cookie、文件传输、并发请求、脚本自动化,最后再补一批我在实际项目里踩过的坑。内容不追求大而全的手册式罗列,而是围绕“实际开发中真正用得上”这条主线来展开。无论你是刚接触命令行的新人,还是天天和接口打交道、却只把 curl 当成“高级 wget”的老手,这篇指南里应该都有你能直接抄走的东西。
1. curl到底能干什么,为什么值得系统掌握
1.1 一个被严重低估的命令行工具
curl 全称是 Command Line URL Tool,名字平平无奇,但它的能力覆盖面比大多数人想象中大得多。它不只是“命令行里发 HTTP 请求”那么简单,它支持的协议包括 HTTP、HTTPS、FTP、SFTP、SMTP、IMAP、POP3、LDAP、RTSP 等一长串。当然日常打交道最多的还是 HTTP/HTTPS,但知道它能干这么多事,你就能理解为什么很多运维脚本里,curl 是那个“万能触手”。
我见过不少人对 curl 的认知停留在 curl http://xxx,然后把返回内容打印到终端上就完事了。但实际上,curl 单是请求相关的参数就有几十个,再加上输出控制、连接控制、认证、代理、传输优化这些维度,组合起来能覆盖开发联调、线上排查、自动化巡检、数据抓取、文件同步等各种各样的场景。可以说,只要涉及“机器与机器之间的数据交换”,curl 几乎都是最先被想到的那批工具里的一个。
也有人觉得,现在图形化接口调试工具那么多,直接鼠标点点不就行了?确实,日常调试用图形化工具很方便,但 curl 有几个不可替代的场景:一是服务器上没法开图形界面,排查问题只能靠命令行;二是脚本化,你不可能让图形工具帮你跑定时任务;三是可复现性,一条 curl 命令可以直接贴给对方,对方复制就能跑,效率和沟通成本完全不一样。这也是为什么很多技术文档、接口文档、开源项目的 README 里,示例请求清一色都是 curl 命令。
1.2 什么人适合学,学到什么程度算学会
这篇内容适合三类人。第一类是刚开始接触命令行和 HTTP 协议的初学者,你可能连 -X POST 和 -d 是什么意思都还不清楚,没关系,我会从最原始的请求讲起,你跟着敲一遍就能理解。第二类是日常写代码、调接口的开发者,前端、后端、测试都算在内,你可能已经会用 curl 发 GET 和 POST 了,但遇到认证、Cookie、文件上传、代理这些场景时还是有点含糊,这篇文章会把常见的高级用法串起来讲。第三类是运维和 SRE 同学,你们大概率已经在脚本里用 curl 了,但你可能还不知道 --retry、--connect-timeout、--write-out 这些参数能帮你省多少事。
那“学会 curl”到底是一个什么状态?我的定义很朴素:给你一个接口文档,你能徒手写出对应的 curl 命令,并且对每个用到的参数都知道是干什么的、为什么要加、不加行不行;给你一个线上故障,你能用 curl 快速判断是网络问题、DNS 问题、证书问题、代理问题还是后端逻辑问题;给你一个自动化需求,你能把 curl 嵌进脚本里,配合条件判断和输出解析,完成接口监控或数据采集。达到这几条,curl 就算真正入门到实战了。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 基础语法与高频参数,先把地基打牢
2.1 从一条最简单的命令开始学起
curl 最基本的用法就是一句话:curl <URL>。你把 URL 给它,它把服务器返回的内容打印到标准输出。比如访问一个公开的 API,curl https://api.example.com/v1/users,返回的 JSON 文本直接就在终端里了。看着很简单,但哪怕是最简单的命令,也有几个隐藏细节值得说。
第一个细节是输出长度。接口返回内容很长时,终端显示不完整,很多人第一反应是“让后端把返回改短一点”,其实正确做法有很多:可以加 -o 保存到文件,curl -o resp.json https://api.example.com/v1/users;可以加 -s 静默模式,去掉进度条和错误信息,只保留响应内容本身,方便重定向到文件里做后续处理;还可以配合 jq 之类的工具做格式化,后面我会专门说。第二个细节是 URL 的引号问题。URL 里如果带 & 这种字符,在 shell 里会被解释成“后台执行”,命令行为直接就变了。所以只要 URL 里带了查询参数,我习惯一律加单引号或双引号包起来,这是新手最容易忽略、也最坑的一点。比如:
bash复制curl 'http://api.example.com/search?q=keyword&page=1'
不加引号的话,shell 会把 &page=1 之前的部分当成一个命令放到后台执行,后面那截直接成了另一个命令,结果完全不可控。
输出保存这里还有一个细节:-o 是用来“指定保存文件名”的,-O(大写字
