curl 这东西，安装装起来本该是安装五分钟的事。但上周帮同事在 Windows 上折腾了半天，安装才发现不同系统之间的安装坑完全不一样。写下来，安装省得下次再踩。安装

Linux：基本不用操心

大多数 Linux 发行版出厂就带 curl。安装打开终端敲 curl --version，安装大概率能看到版本号。安装如果没有，安装一条命令搞定：

# Debian / Ubuntu sudo apt install curl # CentOS / Fedora sudo dnf install curl # Arch sudo pacman -S curl

唯一要留意的安装是老旧的 CentOS 7，自带的安装 curl 版本停在 7.29，TLS 1.3 都不支持。安装有些 API 调不通就是安装这个原因。想换新版得加第三方源，安装或者直接编译。我一般懒得折腾，直接用 wget 绕过去，或者扔到 Docker 容器里跑。

macOS：系统自带的够用，但别乱动

macOS 预装了 curl，版本跟着系统走。macOS Ventura 之后大概是 7.86 左右，日常用没问题。有人喜欢用 Homebrew 装一个新版覆盖掉：

brew install curl

装完 Homebrew 会提示你，这个 curl 是 keg-only 的，不在默认 PATH 里。意思是系统那个还在，你得手动改 PATH 或者用完整路径 /opt/homebrew/opt/curl/bin/curl 来调用。我一开始没注意，装完发现 curl --version 还是老版本，愣了几秒才反应过来。

要不要换？看你需求。如果只是下载文件、测试接口，系统自带的完全够。需要 HTTP/3 或者最新特性，再考虑 Homebrew 那版。

Windows：三种路子，各有各的麻烦

Windows 10 1803 之后其实内置了 curl，路径在 C:\Windows\System32\curl.exe。但有个坑：PowerShell 里 curl 是 Invoke-WebRequest 的别名。你敲 curl，跑的根本不是真 curl。得用 curl.exe 才能调到正主。这个别名坑过我不止一次。

想要完整版，三条路：

一是用 winget。 Windows 10/11 自带 winget，直接：

winget install curl.curl

装完需要重开终端，PATH 才生效。winget 装的是官方构建，版本比较新，推荐。

二是去 curl 官网下压缩包。 curl.se/windows 提供 Win64 的 zip，解压后把 bin 目录加到 PATH 就行。适合没有 winget 的老系统。手动配 PATH 这事在 Windows 上永远让人烦躁，但一次配好就一劳永逸。

三是用 Chocolatey 或 Scoop。 如果你已经在用包管理器，那就顺手：

choco install curl # 或 scoop install curl

Scoop 装完不用管理员权限，PATH 自动处理，体验最干净。我现在的 Windows 开发机就是用 Scoop 管的。

验证装没装好

不管哪个平台，装完跑一句：

curl -I https://example.com

能返回 HTTP 头就说明通了。如果报 SSL 证书错误，多半是系统根证书没更新，或者你公司网络在中间做了 TLS 拦截。后者在办公环境里挺常见，别急着怀疑 curl 本身。

一个容易忽略的细节

curl 和 libcurl 是两个东西。你命令行能跑 curl，不代表开发时链接的 libcurl 也是同版本。编译带 curl 支持的程序时，pkg-config --modversion libcurl 查到的版本可能和 curl --version 对不上。这种情况在 macOS 上尤其容易发生——系统 libcurl 和 Homebrew libcurl 并存，编译时链接到哪个全看环境变量。踩过一次，排查了一下午。

装 curl 本身不复杂，复杂的是它跟系统、包管理器、开发环境之间的纠缠。搞清楚这些，后面调接口、写脚本才不会被莫名其妙的问题卡住。

(责任编辑：百科)