slowbyte
首页友链关于

curl 实战速查：下载、请求与调试一把梭

发表于 2026-08-07 2650 字 14 min read

文章目录
Scoop 装的 Anaconda 无法在商店版 PowerShell 打开？
curl —— 一个功能强大的命令行网络传输工具，支持 HTTP/HTTPS/FTP 等多种协议

最早用 curl 是去摸服务器上某个接口通没通，一条 curl url 就搞定，后来下载文件、带请求头、看响应调试全靠它。它的参数看着多，真正常用的也就那么几个。这篇按我的使用习惯把 curl 的常用场景整理成一份速查。

curl 介绍与使用教程

curl —— 一个功能强大的命令行网络传输工具，支持 HTTP/HTTPS/FTP 等多种协议

官方文档：https://curl.se/docs/ 手册：https://curl.se/docs/manpage.html

日常摸服务器，我用的最多的就是 curl：下载软件、测接口、看响应头，全靠它。刚上手那会儿光记参数就头大，-o 和 -O、-s 和 -S，全是字母大小写的区别，稍不留神就翻车。这篇是我把常用场景整理出的速查，从下载到调试一把梭。

1. curl 简介

什么是 curl

curl（Client URL）是一个用 C 语言编写的命令行网络传输工具，名字含义是”客户端 URL”。它是 Linux/macOS 系统自带的标准工具，几乎所有发行版都预装了它。curl 内置在 Linux、macOS 和 Windows 10+ 中，无需额外安装。

核心能力

能力说明
接口测试发送 GET/POST/PUT/DELETE 等 HTTP 请求
文件下载从 HTTP/FTP 服务器下载文件，支持断点续传
文件上传通过 POST/上传表单等方式上传数据
多种协议HTTP、HTTPS、FTP、SFTP、SMTP 等 20+ 协议
认证支持Basic、Digest、Bearer Token、Cookie 等
脚本友好命令行工具，方便在 Shell 脚本中使用
无交互非交互式，适合自动化任务

与 wget 的对比

特性curlwget
协议支持20+ 种主要 HTTP/FTP
接口测试支持（POST/JSON 等）不支持
递归下载不支持支持
输出控制精细（可输出到 stdout）侧重文件下载
上传文件支持弱

适用场景：测试 API 接口、下载软件包用 curl；抓取整个网站目录用 wget。

常用版本查看

curl --version
# curl 8.21.0 (x86_64-pc-linux-gnu) ...

2. 安装方式

2.1 Linux（系统自带）

# Debian/Ubuntu
sudo apt install curl

# Arch Linux
sudo pacman -S curl

# Fedora
sudo dnf install curl

2.2 macOS

# macOS 自带，或用 Homebrew 更新
brew install curl

2.3 Windows

# Windows 10+ 自带 curl.exe，或用包管理器安装
winget install curl

3. 基础用法

3.1 最简用法：获取页面内容

curl https://example.com
# 将 HTML 内容直接打印到终端

3.2 输出到文件

# -o：保存为指定文件名（不输出到终端）
curl -o index.html https://example.com

# 等价写法：-o 后面跟文件名

3.3 静默模式

# -s：静默模式，不显示进度条和错误信息
curl -s https://example.com

# -sS：静默但保留错误信息（推荐，出错时能看到原因）
curl -sS https://example.com

3.4 查看响应头

# -i：同时显示响应头（header）和响应体（body）
curl -i https://example.com

# -I：只显示响应头（等价于 HEAD 请求）
curl -I https://example.com

3.5 不输出任何内容（只检查连通性）

# -o /dev/null：丢弃响应体；-w 输出状态码
curl -s -o /dev/null -w "%{http_code}\n" https://example.com
# 输出：200

4. 接口测试：请求方法

4.1 GET 请求（默认）

curl https://api.example.com/users

4.2 POST 请求

# -X：指定请求方法
curl -X POST https://api.example.com/users

# 带请求体（-d 默认就是 POST，可省略 -X POST）
curl -d "name=zhangsan&age=18" https://api.example.com/users

4.3 PUT / DELETE / PATCH

curl -X PUT https://api.example.com/users/1
curl -X DELETE https://api.example.com/users/1
curl -X PATCH https://api.example.com/users/1

注意：-X POST 后如果没有 -d，则请求体为空。-d 会自动把方法设为 POST，也会自动加 Content-Type: application/x-www-form-urlencoded。

5. 接口测试：请求头与参数

5.1 设置请求头

# -H：设置单个请求头，可多次使用
curl -H "Accept: application/json" \
     -H "User-Agent: Mozilla/5.0" \
     https://api.example.com/users

5.2 URL 查询参数

# 直接拼在 URL 后面
curl "https://api.example.com/users?page=1&size=10"

# 或用 -G + --data-urlencode 自动编码（避免特殊字符问题）
curl -G https://api.example.com/users \
     --data-urlencode "keyword=spring boot" \
     --data-urlencode "page=1"

5.3 表单数据

# 表单编码（application/x-www-form-urlencoded）
curl -d "username=admin&password=123456" https://api.example.com/login

# 文件作为表单字段上传（multipart/form-data）
curl -F "file=@./report.pdf" \
     -F "remark=月度报告" \
     https://api.example.com/upload
# 发送 Cookie
curl -H "Cookie: sessionid=abc123" https://api.example.com/me

# 或使用 -b：从字符串或文件读取 Cookie
curl -b "sessionid=abc123" https://api.example.com/me
curl -b cookies.txt https://api.example.com/me

# -c：把服务器返回的 Set-Cookie 保存到文件（模拟登录保持会话）
curl -c cookies.txt -d "username=admin&password=123456" https://api.example.com/login
curl -b cookies.txt https://api.example.com/me

6. 接口测试：JSON 与认证

6.1 发送 JSON 请求

# -H 设置 Content-Type，-d 传 JSON 字符串
curl -X POST https://api.example.com/users \
     -H "Content-Type: application/json" \
     -d '{"name": "zhangsan", "age": 18}'

# 从文件读取 JSON（大数据时更清晰）
curl -X POST https://api.example.com/users \
     -H "Content-Type: application/json" \
     -d @user.json

6.2 Basic 认证

# -u：用户名:密码，自动加 Authorization: Basic 头
curl -u admin:123456 https://api.example.com/admin

# 不写密码会交互式提示输入（更安全）
curl -u admin https://api.example.com/admin

6.3 Bearer Token（JWT）

curl -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
     https://api.example.com/me

6.4 简化写法

# curl 8.x 支持 -J 自动识别，或用简写
curl -X POST ...

# 常用简写对照（curl 支持单字母短选项）
# -H 等价 --header，-d 等价 --data，-X 等价 --request

7. 下载软件包

7.1 下载并保存为服务器文件名

# -O：大写 O，使用 URL 中的文件名保存
curl -O https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/Anaconda3-2024.10-1-Linux-x86_64.sh

7.2 下载并指定文件名

# -o：小写 o，自定义文件名
curl -o jdk-21.tar.gz https://download.oracle.com/java/21/latest/jdk-21_linux-x64_bin.tar.gz

7.3 跟随重定向（重要）

# -L：跟随 301/302 重定向，下载时几乎必须加
curl -L -O https://github.com/git/git/archive/refs/tags/v2.47.0.tar.gz

# GitHub 的 release 下载都经过重定向，不加 -L 只会下载到跳转页

7.4 下载带文件名 + 重定向

# -LO 是下载软件包最常用的组合
curl -LO https://nodejs.org/dist/v22.11.0/node-v22.11.0-linux-x64.tar.xz

7.5 批量下载

# 多 URL 下载（会保存各自的文件名）
curl -O https://example.com/a.tar.gz -O https://example.com/b.tar.gz

# 配合 xargs 从文件列表批量下载
cat urls.txt | xargs -n1 -P4 curl -O

8. 高级下载与断点续传

8.1 断点续传

# -C -：从上次中断的地方继续下载（大文件下载必备）
curl -C - -O https://mirrors.aliyun.com/ubuntu-releases/24.04/ubuntu-24.04-live-server-amd64.iso

8.2 限制下载速度

# --limit-rate：限制速度为 500KB/s
curl --limit-rate 500K -O https://example.com/big.iso

8.3 下载多个文件（curl 8.x）

# --parallel：并行下载多个 URL
curl --parallel -O https://example.com/a.iso -O https://example.com/b.iso

# 默认串行；--parallel-max 控制并行数
curl --parallel-max 3 --parallel -O url1 -O url2

8.4 代理下载（加速/翻墙场景）

# -x：指定代理服务器
curl -x http://127.0.0.1:7890 -O https://github.com/xxx/repo/releases/download/v1.0/app.tar.gz

# 或者从环境变量读取代理
export https_proxy=http://127.0.0.1:7890
curl -O https://github.com/xxx/app.tar.gz

8.5 跳过证书校验（仅限测试环境）

# -k：跳过 SSL 证书校验（自签名证书时用，注意安全）
curl -k https://self-signed.example.com/api

# 指定自定义 CA 证书
curl --cacert /path/to/ca.crt https://example.com

9. 其他实用功能

9.1 超时控制

# --connect-timeout：连接超时（秒）
# -m：总超时时间（秒），防止命令卡死
curl -m 10 --connect-timeout 3 https://api.example.com/slow-api

# 示例：脚本中请求超时自动失败
if curl -s -m 5 -o /dev/null https://api.example.com/health; then
  echo "服务正常"
else
  echo "服务异常"
fi

9.2 查看耗时统计

# -w：输出自定义信息，\n 换行
curl -s -o /dev/null -w "HTTP状态码: %{http_code}\nDNS解析: %{time_namelookup}s\n连接时间: %{time_connect}s\nTLS握手: %{time_appconnect}s\n总耗时: %{time_total}s\n" \
     https://api.example.com

9.3 上传文件

# 二进制上传（POST 原始数据）
curl -X POST --data-binary @local.zip https://api.example.com/upload

# PUT 上传（覆盖式上传文件）
curl -X PUT -T local.zip https://api.example.com/files/remote.zip

9.4 网页快照/调试输出

# --trace-ascii：记录完整请求/响应到文件
curl --trace-ascii trace.txt https://api.example.com

# 或简写 -v：输出详细交互过程（开发时最常用）
curl -v https://api.example.com

9.5 重试机制

# --retry：失败自动重试次数；--retry-delay：重试间隔
curl --retry 3 --retry-delay 2 -O https://example.com/flaky.tar.gz

9.6 测试负载均衡/多 IP

# --resolve：强制解析到指定 IP（绕过 DNS，测试多节点）
curl --resolve api.example.com:443:127.0.0.1 https://api.example.com/api

9.7 发送 HEAD 请求检查资源是否存在

# 检查链接是否有效
curl -s -o /dev/null -w "%{http_code}\n" -I https://example.com/nonexist
# 输出：404

10. 与 jq 组合处理 JSON

10.1 基础管道

# curl 输出 JSON 后用 jq 格式化/筛选
curl -s https://api.example.com/users | jq .

10.2 实战：提取字段

# 提取 id 和 name
curl -s https://api.example.com/users | jq '.data[] | {id: .id, name: .name}'

# 按字段过滤
curl -s https://api.example.com/users | jq '.data[] | select(.age > 18)'

10.3 实战：请求→提取→再请求

# 先登录拿 token，再带 token 请求（模拟真实业务）
TOKEN=$(curl -s -X POST https://api.example.com/login \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"123456"}' | jq -r '.token')

curl -s -H "Authorization: Bearer $TOKEN" https://api.example.com/me | jq .

jq 是 JSON 处理神器，安装：sudo apt install jq / sudo pacman -S jq，详见 tools/ 目录中相关笔记。

11. 调试与排错

11.1 详细输出（-v）

# 显示请求头、响应头、TLS 握手等完整过程
curl -v https://api.example.com

# 输出解读：
# > 表示发出的请求信息
# < 表示接收到的响应信息
# * 表示 curl 的内部处理信息

11.2 只看请求（模拟发送）

# --trace-ascii /dev/stdout 可查看实际发送的字节
curl --trace-ascii /dev/stdout -d "name=test" https://api.example.com > /dev/null

11.3 常见错误排查

错误原因解决办法
Could not resolve hostDNS 解析失败检查域名拼写、网络、DNS
Connection timed out连接超时加 -m 超时、检查端口/防火墙
SSL certificate problem证书校验失败使用正规 CA 证书，或测试环境 -k
HTTP 301/302 未跳转没加 -L加 -L 跟随重定向
HTTP 403 Forbidden缺少认证/Cookie检查 UA、Cookie、Token
下载的网页不是文件服务器返回跳转页加 -L，或检查 URL

12. 常用命令速查表

功能命令
测试 GET 接口curl https://api.example.com/users
测试 POST 接口curl -X POST -d "key=value" https://api.example.com
发送 JSONcurl -X POST -H "Content-Type: application/json" -d '{"k":"v"}' url
发送认证 Tokencurl -H "Authorization: Bearer <token>" url
带 Cookie 访问curl -b cookies.txt url
下载软件包（自动命名）curl -LO <url>
断点续传curl -C - -O <url>
跟随重定向下载curl -L -O <url>
限制下载速度curl --limit-rate 500K -O <url>
走代理下载curl -x http://127.0.0.1:7890 -O <url>
静默获取状态码curl -s -o /dev/null -w "%{http_code}" url
只查看响应头curl -I url
详细调试curl -v url
设置超时curl -m 10 --connect-timeout 3 url
失败重试curl --retry 3 --retry-delay 2 -O url
JSON + jq 解析`curl -s url
上传文件curl -F "file=@local.zip" url

推荐文章

1
Tools
curl 实战速查：下载、请求与调试一把梭
2
search
知识分享社区 search 模块总览与架构
3
Git
git 重建后连不上远程仓库？冲突这样解决
4
Algorithm
矩阵连乘问题
5
Algorithm
位运算相关宏定义

6
Algorithm
Contest3898 - 计科23级算法设计与分析平时作业-01
7
Algorithm
计算只含加减乘除的中缀表达式
8
Algorithm
算法竞赛中的Lowbit
9
Git
GitHub CLI 实战指南：从安装到常用命令
10
Backend
Spring 循环依赖怎么解决？