設定：安裝您的 AI 程式碼助手

在您可以從 API 設計生成程式碼之前，您需要合適的工具。在本章中，您將安裝一個 AI 驅動的程式碼編輯器，它可以將您的 OpenAPI 規格轉換為可運作的 API。

這大約需要 15 分鐘。結束時，您將擁有一個準備就緒的專業開發環境。

選擇您的 AI 助手

您有兩個極佳的選擇，老實說，無論選哪一個都不會錯。主要區別在於定價。

Cursor 是大多數專業開發者使用的工具。它擁有最精緻的體驗，特別是它的 "Composer" 模式，可以從頭開始生成整個專案。您會獲得一個免費試用期（通常為 2 週），之後是每月 20 美元。如果您對開發是認真的，這很值得。

Windsurf 是完全免費的，並透過其 "Cascade" 模式提供類似的功能。它由 Codeium 構建，這是一家在 AI 編碼領域信譽良好的公司。其體驗幾乎與 Cursor 一樣好，而且是免費的。

推薦建議：從 Windsurf 開始。如果您發現自己經常編碼並想要絕對最好的體驗，稍後再切換到 Cursor。您隨時可以改變主意。

安裝 Windsurf（免費選項）

步驟 1：下載

前往 codeium.com/windsurf 並點擊適用於您作業系統的下載按鈕。安裝程式大約 100MB。

步驟 2：安裝

macOS： 打開下載的 .dmg 檔案並將 Windsurf 拖到您的應用程式資料夾

Windows： 執行安裝程式並按照提示操作（非常簡單）

Linux： 解壓縮檔案並執行安裝腳本

步驟 3：首次啟動

打開 Windsurf。您會看到一個歡迎畫面，要求您建立一個免費帳戶。使用您的電子郵件或透過 GitHub/Google 登入。這大約需要 30 秒。

步驟 4：快速設定

預設設定運作良好，但如果您想自訂：

主題：點擊齒輪圖示 → Theme → 選擇您的偏好

字體大小：Settings → Editor → Font Size（我們推薦 14）

自動儲存：Settings → Files → Auto Save → 設定為 "afterDelay"

就是這樣。Windsurf 已經準備就緒。

安裝 Cursor（付費選項）

步驟 1：下載

訪問 cursor.sh 並下載適用於您系統的安裝程式。大約 150MB。

步驟 2：安裝

macOS： 打開 .dmg 並拖到應用程式

Windows： 執行 .exe 安裝程式

Linux： 使用提供的 AppImage 或 .deb 套件

步驟 3：開始試用

啟動 Cursor 並建立帳戶。您將獲得免費試用期（查看其網站以獲取當前優惠，通常為 2 週）。試用不需要信用卡。

步驟 4：配置

Cursor 開箱即用效果很好，但這裡有一些有用的調整：

啟用 Composer：Settings → Features → Composer（預設應為開啟）

設定您的首選模型：Settings → Models → 選擇 GPT-4 或 Claude（Claude Sonnet 3.5 非常出色）

隱私：Settings → Privacy → 決定是否要分享匿名使用數據

您已經準備就緒。

驗證您的安裝

讓我們確保一切運作正常。這對 Cursor 和 Windsurf 都是一樣的。

建立一個測試專案：

打開您的 AI 編輯器

點擊 "Open Folder" 或 File → Open Folder

在某處建立一個新資料夾（如 Desktop/api-test）

選擇該資料夾

測試 AI 助手：

按 Cmd+L (Mac) 或 Ctrl+L (Windows/Linux) 打開聊天面板

輸入："Create a simple hello world Python script"

按 Enter

您應該會看到 AI 生成一個 Python 腳本。如果它生成了，說明一切運作正常。如果沒有，請檢查：

您是否已連接到網路

您是否已登入帳戶

AI 面板實際上是否已打開（檢查側邊欄）

對於 Cursor 使用者 - 測試 Composer：

按 Cmd+I (Mac) 或 Ctrl+I (Windows/Linux)

這將打開 Composer 模式

輸入："Create a basic FastAPI project structure"

看著它生成多個檔案

對於 Windsurf 使用者 - 測試 Cascade：

點擊側邊欄中的 Cascade 圖示（看起來像瀑布）

輸入："Create a basic FastAPI project structure"

它應該會生成多個檔案

如果您能生成程式碼，您就準備好了。

安裝 Python

您需要 Python 來實際執行生成的 API 程式碼。這是最快的安裝方法。

檢查您是否已經擁有它：

打開您的終端機（Mac/Linux 上的 Terminal，Windows 上的 PowerShell）並輸入：

如果您看到類似 "Python 3.10.x" 或更高的版本，那就好了。跳到下一節。

如果您沒有 Python 3.10+：

macOS：
最簡單的方法是使用 Homebrew。如果您沒有 Homebrew，請先安裝它：

然後安裝 Python：

Windows：

前往 python.org/downloads

下載 Python 3.11 或 3.12

執行安裝程式

重要： 在安裝過程中勾選 "Add Python to PATH"

Linux (Ubuntu/Debian)：

驗證安裝：

這兩個指令都應該運作並顯示版本號。

了解您的新工具

既然一切都安裝好了，這就是您實際上擁有的：

您的 AI 編碼助手（Cursor 或 Windsurf）是一個內建 AI 的程式碼編輯器。把它想像成 VS Code，但 AI 可以看到您的整個專案，了解上下文，並一次跨多個檔案生成或修改程式碼。這不僅僅是自動完成。

當您將 OpenAPI 規格提供給它並要求它構建 API 時，它了解：

Web API 專案的結構

如何根據您的端點設定路由

使用什麼庫進行身分驗證、驗證等

如何連接到資料庫

常見模式和最佳實踐

品質出奇的好。它不會是完美的，但它會給您可運作的程式碼，您可以理解、測試和修改。

Python 是我們將使用的程式語言。如果您以前從未寫過 Python，請別擔心。 AI 編寫程式碼，而 Python 是可讀性最高的語言之一。您會在過程中學會它。

初次體驗提示

從小處著手。 當您第一次使用 AI 時，不要試圖一次生成整個 API。先讓它解釋一些簡單的東西。習慣它的運作方式。

提問。 如果 AI 生成了您不理解的程式碼，請讓它解釋。"這個函式做什麼？" 或 "為什麼我們需要這個庫？" 它在教學方面出奇的好。

不要盲目信任它。 AI 會犯錯。務必測試它生成的程式碼。這就是為什麼我們有 Apidog - 來驗證一切實際上是否運作正常。

迭代。 如果您不喜歡它生成的東西，請讓它更改。"讓這個更簡單" 或 "在這裡新增錯誤處理" 很有效。

儲存您的工作。 兩個編輯器都有自動儲存，但要養成使用版本控制的習慣（我們稍後會介紹）。

下一步是什麼

您現在擁有：

✓ 已安裝並運作正常的 AI 編碼助手

✓ 已安裝並驗證的 Python

✓ 對這些工具如何運作的基本了解

接下來，您將從 Apidog 匯出您的 API 設計並生成您的第一個完整專案。這就是事情變得令人興奮的地方。

繼續閱讀 → 快速入門：在 30 分鐘內生成您的 API

設定：安裝您的 AI 程式碼助手

選擇您的 AI 助手#

安裝 Windsurf（免費選項）#

安裝 Cursor（付費選項）#

驗證您的安裝#

安裝 Python#

了解您的新工具#

初次體驗提示#

下一步是什麼#