Windows CMD中Curl的完整指南：安装、使用与自动化实战

1. 为什么在Windows CMD里用Curl？一个被低估的日常利器

如果你和我一样，常年混迹在Windows环境下搞开发、运维或者只是单纯地喜欢折腾，那你肯定对那个黑乎乎的CMD窗口又爱又恨。爱的是它直达系统核心，很多操作快准狠；恨的是它有时候像个老古董，很多在Linux/macOS上习以为常的命令行工具，在它这儿要么没有，要么用起来别别扭扭。Curl，这个在Unix-like世界里如同瑞士军刀般的网络工具，就是这样一个典型。过去，想在Windows的CMD里用Curl，你得自己去官网下载二进制包，手动配置环境变量，步骤繁琐。但现在，情况大不一样了。随着Git for Windows的普及，以及Windows 10/11自身对命令行生态的持续改进，Curl已经悄然成为了Windows CMD和PowerShell里的“常驻居民”。今天这篇日记，我就来详细聊聊，怎么在Windows的命令行环境里，把Curl这把“军刀”用得顺手，以及它如何能实实在在地提升你的工作效率。

很多人对Curl的印象还停留在“一个用来下载文件的命令”。这可就太小看它了。在CMD里，Curl能帮你做很多事情：快速测试一个API接口是否通顺、返回什么数据；不借助浏览器下载网络上的文件；甚至作为简单的HTTP客户端，模拟表单提交、上传文件。尤其是在调试微服务、检查Webhook、或者自动化脚本中需要与网络交互时，有一个随手可用的Curl，能省去你打开Postman或者写一段Python脚本的时间。它的魅力在于“一句话的事”。比如，最近很火的Ollama（一个本地运行大模型的工具），其官方安装命令就是一行Curl：curl -fSSL https://ollama.com/install.sh | sh。虽然这条命令在Windows原生CMD里不能直接照搬（因为管道到sh需要Unix shell），但它清晰地展示了Curl在现代工具链中的核心地位——作为获取和传递数据的桥梁。

那么，在Windows的CMD中，我们具体能如何获取并使用Curl呢？主要有三个来源，它们各有优劣，适合不同的场景。

1.1 来源一：系统自带（Windows 10 1803+ / Windows 11）

这是最“无痛”的方式。从Windows 10版本1803开始，微软在系统内部集成了一个Curl版本。你不需要安装任何东西，只需要打开CMD或者PowerShell，直接输入curl就能用。

验证与特点：打开CMD，输入：

curl --version

如果返回类似curl 7.83.1 (Windows) libcurl/7.83.1 ...的信息，恭喜你，系统自带的Curl已就绪。

优点：

• 开箱即用：无需任何额外安装步骤，最适合在陌生的、权限受限的服务器或电脑上快速使用。
• 与系统集成：理论上与Windows的证书存储等结合得更好。

缺点与坑点：

• 版本可能较旧：系统集成的版本更新不频繁，可能缺少一些新特性或安全补丁。例如，某些需要特定TLS版本或新协议支持的场景可能会遇到问题。

• 与PowerShell的别名冲突：这是一个巨坑！在PowerShell中，curl和wget实际上是Invoke-WebRequest这个cmdlet的别名。这意味着你在PowerShell里输入curl，实际调用的是PowerShell自己的命令，参数语法和真正的Curl完全不同，会导致命令执行失败或行为诡异。

  解决方案：

  1. 在PowerShell中使用Curl的完整路径。系统自带的Curl通常位于C:\Windows\System32\curl.exe。你可以使用：

     C:\Windows\System32\curl.exe --version

  2. 或者，在PowerShell脚本或临时会话中删除这个别名：

     Remove-Item Alias:curl -ErrorAction SilentlyContinue Remove-Item Alias:wget -ErrorAction SilentlyContinue

     执行后，curl就会指向真正的curl.exe。但请注意，这仅对当前会话有效。

注意：由于这个别名冲突非常普遍且容易让人困惑，我个人建议，在Windows下进行严肃的、可复现的Curl操作时，优先使用Git Bash或明确指定curl.exe。

1.2 来源二：Git for Windows（推荐方案）

这是我最推荐给开发者的方式。当你安装Git for Windows时，它会附带一个完整的MinGW/MSYS2环境，其中就包含了一个更新更及时的Curl版本，以及一整套Unix工具（如ls,grep,awk,ssh等）。

安装与验证：

1. 前往 Git 官网 下载安装程序。
2. 安装过程中，在“Select Components”步骤，确保“Git Bash Here”和“Git from the command line and also from 3rd-party software”被选中。在“Choosing the default editor”和后续步骤中，按个人喜好选择即可。
3. 安装完成后，你会有两种方式使用Curl：
   • Git Bash：这是一个模拟的Linux终端，在这里你可以使用几乎所有的Unix命令，语法和Linux下一致。直接打开Git Bash，输入curl --version即可。
   • 系统PATH：如果你在安装时选择了上面提到的第二个选项，Git的cmd目录会被添加到系统的PATH环境变量中。这意味着你可以在CMD或PowerShell中直接使用curl命令，而且这个curl是Git自带的版本，通常比系统自带的更新。

验证PATH中的Curl：在CMD中，输入：

where curl

如果输出路径包含Git\mingw64\bin\curl.exe之类的，说明你正在使用Git附带的Curl。再输入curl --version查看版本，通常比系统自带的要新。

优点：

• 版本较新：Git for Windows项目会定期更新其组件包，包含的Curl版本较新。
• 环境统一：对于开发者而言，Git Bash提供了一个接近Linux的环境，很多脚本和命令可以直接迁移或稍作修改即可运行，减少了上下文切换成本。
• 无别名冲突：在Git Bash里，curl就是真正的curl。在CMD里通过PATH调用，也是真正的curl.exe，避免了PowerShell的别名问题。

缺点：

• 需要额外安装Git（但这对开发者来说是必需品）。
• 如果系统PATH中有多个curl，可能会产生混淆，where curl命令可以帮助你确定当前调用的是哪一个。

1.3 来源三：手动安装官方二进制包

这种方式最直接，也最灵活，适合需要特定版本或希望完全掌控的高级用户。

步骤：

1. 访问官方站点：打开 curl.se/windows 。
2. 选择版本：网站提供了多种构建版本。对于大多数用户，建议下载“With SSH”版本的ZIP包，因为它包含了SCP/SFTP等协议支持。选择与你系统架构匹配的版本（通常是64位的Win64）。
3. 解压与放置：将下载的ZIP包解压到一个你喜欢的目录，例如D:\Tools\curl。
4. 配置PATH：将解压后目录下的bin文件夹路径（例如D:\Tools\curl\bin）添加到系统的环境变量PATH中。
5. 验证：打开一个新的CMD窗口，输入curl --version，确认显示为你安装的版本。

优点：

• 版本可控：可以自由选择任何历史版本或最新版本。
• 功能定制：可以选择带不同功能（如SSL库、SSH、IDN等）的构建版本。
• 纯净独立：不依赖系统或Git，干净利落。

缺点：

• 步骤相对繁琐，需要手动维护和更新。
• 对于新手，管理PATH和环境变量可能有些挑战。

2. CMD中Curl核心语法与高频使用场景拆解

无论Curl来自哪里，其核心命令语法是通用的。在CMD环境下使用，主要需注意命令参数格式和文件路径的表示方法与Linux终端的细微差别。下面我们结合具体场景来看。

2.1 基础中的基础：下载与保存文件

这是Curl最直观的功能。在CMD中，由于管道符|和重定向>依然有效，所以下载文件非常直接。

场景一：直接下载文件到当前目录（使用默认文件名）

curl -O https://example.com/path/to/file.zip

这里的-O（大写字母O）参数告诉curl，将远程文件保存到本地，并使用服务器上的原始文件名（file.zip）。这是最常用的下载单个文件的方式。

场景二：下载并重命名文件

curl -o myfile.zip https://example.com/path/to/file.zip

这里的-o（小写字母o）后面接本地文件名，可以自由指定保存后的名称。

场景三：将文件内容输出到控制台，或通过管道传递

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

不加-O或-o参数，curl会将获取到的内容直接打印在CMD窗口中。这在查看API响应、检查网页源码时非常有用。你也可以将其重定向到文件：

curl https://example.com/api/version > version.txt

或者通过管道传递给其他命令处理（前提是其他命令支持从标准输入读取）：

curl -s https://raw.githubusercontent.com/某个脚本地址 | python

（注意：在原生CMD中，管道传递复杂脚本可能受限，更复杂的操作建议在PowerShell或Git Bash中进行）

2.2 进阶必备：模拟API请求与调试

这才是Curl大放异彩的地方。在前后端联调、测试Webhook或验证第三方接口时，它比打开图形界面工具快得多。

场景四：发送GET请求并查看详细响应信息

curl -v https://jsonplaceholder.typicode.com/posts/1

-v（verbose）参数至关重要，它会输出整个HTTP交互的详细过程，包括请求头、响应头等。这是调试网络问题的第一利器。

场景五：发送POST请求，提交JSON数据

curl -X POST https://example.com/api/users \ -H "Content-Type: application/json" \ -d "{\"name\": \"John\", \"email\": \"john@example.com\"}"

• -X POST：指定请求方法为POST。
• -H "Content-Type: application/json"：设置请求头，告诉服务器我们发送的是JSON格式数据。在CMD中，包含空格和引号的参数必须用双引号整体括起来。
• -d "{\"name\": ...}"：-d参数用于发送请求体数据。注意，在CMD中，JSON字符串内部的双引号需要进行转义，即写成\"。这是Windows CMD和Linux shell的一个重要区别。在PowerShell或Git Bash中，可以使用单引号来避免转义：-d '{"name": "John"}'。

场景六：发送表单数据（application/x-www-form-urlencoded）

curl -X POST https://example.com/login \ -d "username=admin&password=secret"

默认情况下，使用-d参数且不设置Content-Type头，curl会自动设置为application/x-www-form-urlencoded。

场景七：上传文件（multipart/form-data）

curl -X POST https://example.com/upload \ -F "file=@C:\Users\Me\Pictures\photo.jpg" \ -F "caption=My holiday photo"

-F参数用于构建 multipart 表单提交。file=@<文件路径>的语法用于上传文件。这里要特别注意Windows文件路径的写法，需要使用反斜杠\，并且如果路径包含空格，整个-F参数值需要用双引号包围，但@符号应在引号内：-F "file=@\"C:\My Documents\photo.jpg\""。为了避免麻烦，尽量将文件放在无空格路径下。

2.3 实用技巧：处理认证、Cookie与重定向

场景八：使用Bearer Token进行API认证

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" https://api.example.com/protected-resource

场景九：处理Cookie——保存与发送

# 登录并将服务器返回的Cookie保存到文件 curl -c cookies.txt -X POST https://example.com/login -d "user=me&passwd=secret" # 使用保存的Cookie访问需要登录的页面 curl -b cookies.txt https://example.com/dashboard

-c将服务器返回的Cookie写入文件。-b从文件读取Cookie并随请求发送。

场景十：跟随重定向

curl -L https://example.com/short-url

-L参数让curl自动跟随HTTP 3xx重定向，直到获取最终内容。这在处理短链接或某些登录跳转时非常必要。

3. 在Windows CMD中使用Curl的独家避坑指南

Windows环境有其特殊性，直接照搬Linux教程里的Curl命令，十有八九会出错。下面是我踩过的一些坑和对应的解决方案。

3.1 路径与引号转义：最大的“拦路虎”

这是Windows CMD和Unix shell最根本的差异之一。

问题1：JSON数据中的双引号在Linux的Bash中，你可以写：curl -d '{"key": "value"}' ...。单引号内的内容会被原样传递。 在Windows CMD中，单引号不是有效的字符串界定符。你必须使用双引号，并且对数据内部的双引号进行转义：

# CMD中的正确写法 curl -d "{\"key\": \"value\"}" ... # 更复杂的例子 curl -X POST ... -H "Content-Type: application/json" -d "{\"title\": \"Hello\", \"body\": \"World\", \"userId\": 1}"

如果你觉得转义很麻烦，一个取巧的办法是将JSON数据先写在一个文件里，然后让curl从文件读取：

# 先将JSON内容保存到文件 data.json echo {"title": "Hello", "body": "World", "userId": 1} > data.json # 注意：上面的echo在CMD中可能无法完美生成带双引号的JSON，最好用文本编辑器创建文件。 # 然后使用 @ 符号从文件读取数据 curl -X POST ... -H "Content-Type: application/json" -d @data.json ...

问题2：文件路径中的空格和特殊字符-F “file=@C:\My Documents\file.txt”这样的命令会失败，因为路径中有空格。解决方案：

1. 使用短文件名（8.3格式）：在CMD中，dir /x可以查看目录的短名称。例如C:\My Documents\可能对应C:\MYDOCU~1\。但这种方法不直观且不稳定。
2. 对路径加引号并转义内部引号：

   curl -F "file=@\"C:\My Documents\file.txt\"" ...

   即在完整的文件路径外加一层双引号，并对这层引号进行转义。
3. （推荐）使用PowerShell或Git Bash：在这些环境中，路径处理更接近Linux，可以直接使用单引号或更智能的引号解析。例如在PowerShell中：curl -F ‘file=@“C:\My Documents\file.txt”’ ...。

3.2 管道与PowerShell的“爱恨情仇”

网络热词里有一条curl -fSSL https://ollama.com/install.sh | sh，这在原生CMD中是无法执行的，因为CMD没有sh这个命令。这条命令的本意是：用curl下载安装脚本，然后通过管道交给sh（Unix shell解释器）执行。

在Windows上如何应对这种模式？

1. 使用Git Bash：这是最完美的解决方案。在Git Bash中，你可以几乎原封不动地运行很多Linux风格的命令链。
2. 分步手动操作：
   • 第一步，用curl只下载脚本文件：curl -O https://ollama.com/install.sh（或-o install.sh）。
   • 第二步，仔细阅读下载下来的install.sh脚本内容（用记事本或其他编辑器），理解它要做什么。通常这类脚本做的事情是：检测系统、下载二进制包、设置环境变量等。
   • 第三步，根据脚本逻辑，在Windows上手动执行相应的操作。这可能包括：下载特定的Windows版本安装包（.exe或.msi）、手动添加路径到环境变量等。
3. 寻找官方的Windows安装方式：像Ollama这样的现代工具，通常都会提供直接的Windows安装程序（.exe）。直接使用官方推荐的Windows安装方式总是最稳妥的。

3.3 证书问题：SSL连接失败

有时使用自签证书的内部站点，或者某些旧版本的curl，可能会遇到SSL证书验证失败的问题。

curl: (60) SSL certificate problem: unable to get local issuer certificate

临时解决方案（仅用于测试环境）：使用-k或--insecure参数，让curl跳过证书验证。注意：这会使连接面临中间人攻击风险，切勿在生产脚本或访问重要网站时使用。

curl -k https://internal-server/api

根本解决方案：

• 如果是系统自带或Git附带的curl，确保系统的根证书库是最新的。
• 如果是手动安装的curl，可能需要指定证书捆绑包（cacert.pem）的路径。在curl的官方二进制包中，通常会在bin目录的上级目录找到cacert.pem文件。你可以通过--cacert参数指定它：

  curl --cacert “D:\Tools\curl\cacert.pem” https://example.com

3.4 编码与输出乱码

如果curl获取到的网页内容在CMD中显示为乱码，这通常是字符编码问题（如UTF-8编码的内容在默认代码页为GBK的CMD窗口中显示异常）。解决方案：

1. 将输出重定向到文件，然后用支持UTF-8的编辑器（如VSCode、Notepad++）打开查看。

   curl https://example.com/page > output.html

2. 在运行curl命令前，先更改CMD的代码页为UTF-8：

   chcp 65001

   然后执行curl命令。但请注意，更改代码页后，CMD自身的字体可能需要设置为TrueType字体（如“Lucida Console”）才能正确显示。

4. 实战：将Curl融入Windows自动化工作流

Curl不仅仅是一个手动输入的命令，它更是自动化脚本的强力胶水。结合Windows的批处理（.bat）或PowerShell脚本（.ps1），可以完成很多重复性工作。

4.1 构建一个简单的健康检查脚本

假设你需要定时检查一组内部服务的HTTP状态。

创建一个health_check.bat文件：

@echo off REM 健康检查脚本 echo [%date% %time%] 开始服务健康检查... REM 检查服务A curl -s -o nul -w “%%{http_code}” https://service-a.internal.com/health if not errorlevel 1 ( echo 服务A: 状态正常 ) else ( echo 服务A: 状态异常 >> health_check.log ) REM 检查服务B，并设置超时 curl -s -o nul -w “%%{http_code}\n” --max-time 5 https://service-b.internal.com/health if errorlevel 28 ( echo 服务B: 请求超时 >> health_check.log ) echo [%date% %time%] 检查完成。 pause

脚本解析：

• @echo off：关闭命令回显，让输出更干净。
• -s：静默模式，不显示进度条或错误信息。
• -o nul：将输出内容重定向到空设备，即丢弃响应体，我们只关心HTTP状态码。
• -w “%%{http_code}”：-w用于格式化输出，这里只输出HTTP状态码。在批处理文件中，百分号%需要转义写成%%。
• if not errorlevel 1：errorlevel是上一条命令的退出码。curl命令成功时返回0。not errorlevel 1等价于errorlevel == 0。
• --max-time 5：设置整个操作最大超时时间为5秒。
• if errorlevel 28：curl在超时时的退出码是28。

你可以使用Windows任务计划程序（Task Scheduler）来定时运行这个批处理脚本。

4.2 使用PowerShell实现更强大的自动化

PowerShell在处理JSON响应、错误控制方面比CMD批处理更强大。

创建一个fetch_data.ps1文件：

# 首先，确保使用的是真正的curl，不是PowerShell的别名 $curlExe = “curl.exe” # 或者使用完整路径，如 “C:\Program Files\Git\mingw64\bin\curl.exe” # 定义API地址和Token $apiUrl = “https://api.example.com/data” $token = “YOUR_BEARER_TOKEN_HERE” try { # 执行curl请求，将JSON响应转换为PowerShell对象 $response = & $curlExe -s -H “Authorization: Bearer $token” $apiUrl | ConvertFrom-Json # 处理数据 Write-Host “获取到 $($response.items.Count) 条数据。” -ForegroundColor Green foreach ($item in $response.items) { # 对每条数据进行一些操作，例如保存部分信息到日志 “[$([datetime]::Now)] 处理项目: $($item.id) - $($item.name)” | Out-File -Append -FilePath “process.log” } } catch { Write-Host “请求失败: $_” -ForegroundColor Red # 可以在这里添加重试逻辑或发送警报 }

脚本解析：

• & $curlExe ...：使用调用操作符&来执行存储在变量中的命令。
• -s：静默模式。
• | ConvertFrom-Json：将curl获取到的JSON字符串通过管道传递给PowerShell的ConvertFrom-Jsoncmdlet，将其转换为便于操作的PSCustomObject对象。
• try...catch：进行错误处理。
• Write-Host -ForegroundColor：在控制台输出彩色信息，提升可读性。
• Out-File -Append：将内容追加到日志文件。

这个脚本展示了如何将Curl作为数据获取器，PowerShell作为数据处理器，两者结合实现复杂的自动化任务。

4.3 解决“脚本闪退”和“隐藏窗口”问题

网络热词中提到了“windows脚本命令闪退”和“运行bat+命令行+隐藏窗口”。当你双击运行一个包含curl命令的.bat文件时，CMD窗口可能会在执行完毕后立即关闭，让你看不到任何输出或错误信息。

解决方案：

1. 在脚本末尾添加pause命令：如上文的示例，这会暂停脚本，等待用户按任意键后才关闭窗口。适用于调试。
2. 使用cmd /k运行：你可以创建一个快捷方式，目标设置为cmd /k “C:\path\to\your\script.bat”。/k参数表示运行命令后保持窗口打开。
3. 需要静默运行（隐藏窗口）时：
   • 对于批处理，可以使用VBScript或JavaScript启动它并隐藏窗口，但这比较复杂。
   • 更推荐使用PowerShell：可以方便地以后台作业方式运行脚本，或者将脚本包装成Windows服务。对于简单的隐藏窗口运行，可以这样启动PowerShell脚本：

     powershell -WindowStyle Hidden -File “C:\path\to\your\script.ps1”

     但这通常需要先修改PowerShell的执行策略（Set-ExecutionPolicy）。

经过这一番从安装、语法、避坑到实战的梳理，相信你已经对在Windows CMD这个“老伙计”手里驾驭Curl这把“瑞士军刀”有了充分的信心。核心就是三点：选对来源（优先Git Bash）、理解差异（主要是路径和引号）、融入流程（结合脚本自动化）。下次再遇到需要快速测试接口、抓取数据或者调试网络的小任务，别再急着打开笨重的图形工具了，试着在CMD里敲下一行curl命令，你会发现这种直达核心的效率感，一旦习惯就再也回不去了。