---

Curl 参数详解：掌控网络请求，实现内容直达屏幕

在现代软件开发和系统管理中，与 Web 服务进行交互是一项基本技能。无论是测试 API、下载文件、自动化任务，还是简单地获取网页内容，命令行工具 curl 都是不可或缺的瑞士军刀。它功能强大、灵活，支持多种协议（HTTP, HTTPS, FTP, SCP, LDAP 等），并提供了丰富的参数来精确控制请求的每一个细节。

本文的核心目标是深入探讨 curl 的一项基础但极其有用的功能：将下载的网络内容直接输出到标准输出（屏幕）。虽然这是 curl 的默认行为之一，但理解相关的参数能让我们更精细地控制输出格式、处理重定向、过滤信息、以及将其无缝集成到脚本和命令行管道中。我们将详细解析与屏幕输出相关的 curl 参数，并通过实例展示其应用。

一、curl 与标准输出 (stdout)

在类 Unix 系统（如 Linux, macOS）中，每个进程默认都有三个标准流：
1. 标准输入 (stdin)：进程从中读取数据，通常是键盘输入。
2. 标准输出 (stdout)：进程向其写入正常输出，通常显示在终端屏幕上。
3. 标准错误 (stderr)：进程向其写入错误或诊断信息，也通常显示在终端屏幕上，但与 stdout 是分开的流。

curl 的设计哲学遵循了 Unix 的“一切皆文件”和管道思想。默认情况下，当你执行一个简单的 curl 请求以下载资源时（例如 curl http://example.com），curl 会将接收到的 响应体 (response body) 内容写入到 标准输出 (stdout)。同时，它会将 进度信息、连接详情和错误消息 写入到 标准错误 (stderr)。

这种默认行为非常方便，因为它允许我们：
* 直接在屏幕上查看文本内容（如 HTML, JSON, XML, 纯文本）。
* 使用管道符 | 将 curl 的输出传递给其他命令进行处理（如 grep, jq, sed, awk, less 等）。

示例：默认行为

“`bash

请求一个简单的 HTML 页面

curl http://info.cern.ch/hypertext/WWW/TheProject.html
“`

执行上述命令后，你将在终端上看到该网页的 HTML 源代码。这正是 curl 将响应体输出到 stdout 的结果。

二、核心参数：控制输出目标与内容

虽然默认输出到 stdout 很方便，但有时我们需要更精细的控制。以下是一些关键参数，它们直接或间接地影响着内容是否以及如何输出到屏幕。

1. -o, --output <file>：将输出重定向到文件

这是最常用于 阻止 内容输出到屏幕的参数。它告诉 curl 将响应体保存到一个指定的文件中，而不是 stdout。

“`bash

将 example.com 的 HTML 保存到 index.html 文件，屏幕上只显示进度和错误信息（stderr）

curl -o index.html http://example.com
“`

特殊用法 -o -：
-o 参数有一个特殊的值 -（单个连字符）。当使用 -o - 时，它明确指示 curl 将响应体输出到 stdout。这在某些情况下很有用，例如：
* 当脚本或别名可能默认设置了 -o 或 -O 时，用 -o - 可以强制覆盖并输出到屏幕。
* 在复杂的命令组合中，明确指定输出到 stdout 可以提高可读性。

“`bash

明确指定输出到 stdout (效果同默认行为)

curl -o – http://example.com
“`

2. -O, --remote-name：以远程文件名保存

这个参数也用于将输出保存到文件，但它会自动使用 URL 中提取的文件名。它同样会阻止内容输出到 stdout。

“`bash

下载文件并以服务器提供的名称保存 (例如 logo.png)，屏幕上只显示进度和错误信息

curl -O https://www.google.com/images/branding/googlelogo/1x/googlelogo_color_272x92dp.png
“`

总结 -o 和 -O：这两个参数是将输出从 stdout 重定向到文件的主要方式。要实现屏幕输出，通常 不 使用它们，或者使用 -o - 来显式指定 stdout。

3. -s, --silent：静默模式

这是实现 干净屏幕输出 的关键参数。默认情况下，curl 会在 stderr 上显示进度条和一些连接信息。如果你只想看到纯粹的响应体内容（例如，在脚本中处理 JSON 或纯文本时），-s 参数可以抑制这些额外的输出。

“`bash

默认情况，stderr 会有进度信息

curl http://example.com

使用 -s，屏幕上只剩下纯粹的 HTML (stdout)，没有进度条

curl -s http://example.com

将 JSON API 的响应直接通过管道传给 jq 处理，-s 确保只有 JSON 数据被传递

curl -s https://api.github.com/users/octocat | jq ‘.name’
“`

注意：-s 会同时抑制进度信息和错误消息（来自 curl 本身，非 HTTP 错误）。

4. -S, --show-error：在静默模式下显示错误

当你使用 -s 静默模式时，如果 curl 自身遇到错误（如无法解析主机、连接超时等）或者 HTTP 请求失败（需要配合 -f），默认情况下错误信息也会被抑制。-S 参数的作用是在 -s 生效的同时，仍然将这些错误消息输出到 stderr。这对于调试脚本非常有用，既能保持 stdout 的干净，又能在出错时获得反馈。

“`bash

尝试访问一个不存在的域名

使用 -s，屏幕无任何输出，也无法知道是否出错 (除非检查退出码 $?)

curl -s http://nonexistent-domain-12345.com

使用 -sS，屏幕无正常输出 (stdout)，但 stderr 会显示 curl 的错误信息

例如：”curl: (6) Could not resolve host: nonexistent-domain-12345.com”

curl -sS http://nonexistent-domain-12345.com
“`

5. -f, --fail：对服务器错误静默处理 (不输出错误页面)

当服务器返回 HTTP 错误状态码（如 404 Not Found, 500 Internal Server Error）时，curl 默认仍然会将服务器返回的错误页面（通常是 HTML）输出到 stdout。-f 参数改变了这种行为：如果发生 HTTP 错误，curl 将 不输出任何响应体 到 stdout，并且会以一个非零的退出码（通常是 22）结束。这在脚本中判断请求是否成功时非常有用，避免了处理预期之外的错误页面内容。

“`bash

请求一个不存在的页面 (假设服务器返回 404 页面)

默认情况，会将 404 错误页面 HTML 输出到屏幕

curl http://example.com/nonexistent-page

使用 -f，如果服务器返回 4xx 或 5xx 错误，屏幕上将没有任何输出 (stdout)

curl 会以错误码退出

curl -f http://example.com/nonexistent-page

结合 -s 和 -f：既隐藏进度，又在 HTTP 错误时不输出错误页面

curl -fs http://example.com/nonexistent-page

结合 -fsS：隐藏进度，HTTP 错误时不输出错误页面，但 curl 自身错误会显示

curl -fsS http://example.com/nonexistent-page
“`

对于需要干净地获取内容到 stdout 的场景，-fs 或 -fsS 的组合非常常见。

6. -L, --location：跟随重定向

很多 Web 资源会使用 HTTP 重定向（状态码 3xx）。默认情况下，curl 不会跟随重定向，它只会请求你指定的 URL，并输出该 URL 返回的响应（可能是一个重定向指令和空的响应体）。要获取重定向 最终 指向的资源内容并输出到屏幕，你需要使用 -L 参数。

“`bash

假设 http://google.com 重定向到 https://www.google.com/

不加 -L，可能只输出重定向信息或空内容

curl -s http://google.com

加 -L，curl 会跟随重定向，最终获取 www.google.com 的内容并输出到屏幕

curl -sL http://google.com
“`

在获取网页或 API 数据时，-L 通常是必需的，以确保你得到的是实际内容而非重定向指令。

7. -i, --include：在输出中包含响应头

默认情况下，curl 只将响应体 (body) 输出到 stdout。如果你想 同时 看到响应头 (headers) 和响应体，可以使用 -i 参数。响应头会先于响应体输出到 stdout。

“`bash

输出响应头和响应体到屏幕

curl -i http://example.com
“`

输出会类似这样：
“`
HTTP/1.1 200 OK
Content-Encoding: gzip
Accept-Ranges: bytes
Age: 54321
Cache-Control: max-age=604800
Content-Type: text/html; charset=UTF-8
Date: Mon, 27 May 2024 10:00:00 GMT
Etag: “3147526947”
Expires: Mon, 03 Jun 2024 10:00:00 GMT
Last-Modified: Thu, 17 Oct 2019 07:18:26 GMT
Server: ECS (dcb/7EA2)
Vary: Accept-Encoding
X-Cache: HIT
Content-Length: 648

… (rest of the HTML body) …

“`

8. -I, --head：仅获取响应头 (发送 HEAD 请求)

如果你只对响应头感兴趣，完全不需要响应体，可以使用 -I 参数。这会让 curl 发送一个 HTTP HEAD 请求，服务器理论上只返回响应头信息。这些头信息会直接输出到 stdout。

“`bash

只获取并显示响应头

curl -I http://example.com
“`

这对于检查资源的 Content-Type、Last-Modified、服务器类型等元数据非常有用，且效率比下载整个响应体高。

9. -D, --dump-header <file>：将响应头保存到文件

与 -i 不同，-D 参数允许你将响应头 单独 保存到一个文件中，而响应体仍然按照默认（或由 -o 指定）的方式处理。这意味着你可以将响应体输出到 stdout，同时将响应头保存到文件以供后续分析。

“`bash

将响应体输出到屏幕 (stdout)，响应头保存到 headers.txt 文件

curl -D headers.txt http://example.com

查看响应头

cat headers.txt
“`

特殊用法 -D -：
类似于 -o -，-D - 指示 curl 将响应头输出到 stdout。但是，要注意，如果同时响应体也默认输出到 stdout，这可能会导致头和体混合在一起，效果类似于 -i。通常 -D - 配合 -o /dev/null（丢弃响应体）或者 -o <file>（将响应体存盘）使用，以单独在屏幕上查看响应头。

“`bash

将响应头输出到屏幕 (stdout)，丢弃响应体

curl -s -D – -o /dev/null http://example.com
“`

10. -v, --verbose：详细输出模式

-v 参数用于调试，它会输出大量的详细信息，包括：
* curl 尝试连接的 IP 地址和端口。
* 发送的请求头（以 > 开头）。
* 接收的响应头（以 < 开头）。
* SSL/TLS 握手信息（如果使用 HTTPS）。
* 其他诊断信息。

这些信息绝大部分都输出到 stderr。响应体仍然输出到 stdout（除非被 -o 或 -O 重定向）。因此，-v 不适合用于获取纯净的响应体到屏幕，但对于理解请求过程中发生了什么至关重要。

“`bash

详细模式，大量调试信息输出到 stderr，响应体输出到 stdout

curl -v http://example.com
“`

三、组合参数与实际应用场景

理解了这些核心参数后，我们可以组合它们来满足不同的屏幕输出需求。

场景 1：获取纯净的 JSON API 响应并用 jq 处理

目标：调用一个 API 端点，获取 JSON 响应，只在屏幕上显示特定字段的值，忽略进度和错误页面。

“`bash

-s: 静默模式，无进度条

-L: 跟随可能存在的重定向

-f: 如果 API 返回 4xx/5xx 错误，不输出错误 JSON/HTML，并设置退出码

curl -fsL https://api.github.com/repos/stedolan/jq | jq ‘.description’
``
这条命令会安静地获取 jq 项目的 GitHub API 信息，如果成功，则将纯净的 JSON 数据通过管道交给jq提取.description字段并输出到屏幕。如果 API 访问失败，屏幕上不会有curl的输出（除非用-S且curl自身出错），jq` 也不会收到输入。

场景 2：快速查看网页标题

目标：获取一个网页的 HTML，并提取 <title> 标签的内容显示在屏幕上。

“`bash

-sL: 静默并跟随重定向

grep -oP: 使用 Perl 兼容正则表达式提取 之间的内容

sed: 清理掉 标签本身

curl -sL http://example.com | grep -oP ‘‘ | sed -e ‘s/