如何在 Windows 10 中使用 cURL：基本指令

Windows 10 內建了curl.exe，因此您無需安裝單獨的工具即可從 PowerShell 或命令提示字元發出 Web 要求。打開終端，確認它正在運行，然後使用 cURL 和 URL 來檢索頁面、檢查回應頭、下載檔案或向 API 發送資料。在 Windows PowerShell 5.1 中，請鍵入 `cURL`curl.exe而不是`cURL` curl，這樣 PowerShell 才會執行真正的 cURL 程式。

使用 curl.exe --version 指令透過 Windows PowerShell 指令檢查已安裝的 cURL 版本。 — 使用 cURL 選項前，請檢查已安裝的 cURL 版本。

1. 打開終端機並檢查 cURL

開啟「開始」選單，搜尋PowerShell或命令提示符，然後正常啟動它。對使用者資料夾的普通請求或下載不需要管理員權限。

curl.exe --version

輸出結果包含已安裝的版本以及該版本中可用的協定和功能。 Windows PowerShell 5.1 內建了curl與該Invoke-WebRequest指令同名的別名，因此從 Linux 教學複製的指令除非使用別名，否則其行為可能會有所不同curl.exe。 PowerShell 7 沒有定義該別名。微軟在其Windows 版 cURL 指南中記錄了這一差異。

2. 提出基本請求

在命令後添加 URL。 cURL 預設使用 HTTP GET 請求，並將回應正文輸出到終端：

curl.exe "https://example.com"

對於網頁，回應格式為 HTML；API 可能會傳回 JSON 或其他格式。這個命令會直接傳遞回應，而不是像瀏覽器那樣進行渲染。如果 URL 中包含空格&或反斜線等字符?，請將完整的 URL 用引號括起來，以便 shell 將其作為一個參數傳遞。

使用 curl.exe 透過 Windows PowerShell 指令向 example.com 傳送基本的 HTTPS 請求 — 基本的 cURL 請求會將伺服器回應列印到終端機中。

3. 檢查響應頭

使用大寫字母-I發送 HEAD 請求，並在不下載回應正文的情況下顯示回應頭：

curl.exe -I "https://example.com"

請求頭可以顯示 HTTP 狀態、內容類型、快取詳情和其他伺服器元資料。某些服務不支援 HEAD 請求，或 HEAD 請求傳回的結果與 GET 請求不同。若要在常規 GET 回應中包含請求頭，請使用小寫字母-i。-L當伺服器重定向請求且您希望 cURL 跟隨該重定向時，請使用此方法。

使用 curl.exe -I 請求回應頭的 Windows PowerShell 命令 — -I 選項僅向伺服器要求回應頭。

4. 將回覆儲存到文件

預設情況下，cURL 會將回應資料列印到終端。您可以使用-o`--filename` 參數來選擇檔案名稱和位置。以下 PowerShell 範例會將 HTML 回應寫入您的「下載」資料夾：

curl.exe -L -o "$env:USERPROFILE\Downloads\example.html" "https://example.com"

-L遵循重定向，同時-o指定輸出檔名。此指令會覆蓋同名文件，因此請謹慎選擇目標位置。若要儲存到目前資料夾，請使用curl.exe -L -o "example.html" "https://example.com"。-O選項（大寫字母 O）則使用 URL 中的檔案名稱：

curl.exe -L -O "https://example.com/files/archive.zip"

第二個 URL 是一個範例格式；請將其替換為實際存在且您有權下載的直接文件 URL。

使用 Windows PowerShell 指令將 HTTPS 回應儲存為 example.html 檔案到 Downloads 資料夾 — -o 選項會將回應寫入指定檔案名稱。

5. 向 API 發送 JSON 數據

對於 JSON POST 要求，請指定方法、內容類型和請求體。將範例端點替換為您自己的 API URL：

curl.exe -X POST "https://api.example.com/items" -H "Content-Type: application/json" -d '{"name":"widget"}'

-X POST選擇 HTTP 方法、-H新增請求頭並-d提供請求體。伺服器必須接受 POST 請求，且 JSON 欄位必須與其 API 相符。如果您的終端歷史記錄或共享日誌可能會洩露密碼、私鑰或其他敏感訊息，請勿將這些資訊貼到命令中。 cURL官方手冊列出了這些選項及其版本要求。

解決常見問題

“無法辨識 curl”。請where.exe curl在 PowerShell 或命令提示字元中執行。在 Windows 10 中，Microsoft 版本的 curl 通常位於 [此處應填入特定路徑] C:\Windows\System32\curl.exe。如果自訂安裝中缺少該可執行文件，請從cURL for Windows 官方頁面下載 Windows 版本，選擇適合您系統的軟體包，然後curl.exe從解壓縮後的資料夾執行。只有當您希望從任何目錄啟動 curl 時，才需要將該資料夾新增至 PATH 環境變數。
PowerShell 提示參數無效。請確保命令以 `.` 開頭curl.exe。在 Windows PowerShell 5.1 中，普通的 `.`curl可能會被呼叫Invoke-WebRequest。
請求失敗，並出現 HTTPS 憑證錯誤。請檢查電腦的日期和時間，更新 Windows 系統，並檢查工作代理程式或安全性產品是否需要受信任的憑證。請勿將其-k作為常規修復方法，因為它會停用證書驗證。