Cursor 實戰完整指南：從安裝到寫出可上線的專案

為什麼要認真學 Cursor

Cursor 是一款以 VS Code 為基礎打造的 AI 程式編輯器。它保留了 VS Code 的擴充套件生態與快捷鍵習慣，但把 AI 深度整合進編輯流程，讓你可以用自然語言描述需求，直接在專案脈絡中生成、修改與重構程式碼。對已經習慣 VS Code 的開發者來說，遷移成本極低，這也是它快速普及的主因。

很多人第一次用 Cursor，只把它當成「會補全的編輯器」，其實這樣浪費了它八成的能力。真正的價值在於它能讀懂整個專案的上下文，跨檔案理解你的程式架構，並在你指定的範圍內做出一致的修改。本文會從安裝到實際交付一個小專案，完整走過一遍。

安裝與基本設定

到官方網站下載對應作業系統的安裝檔，安裝流程與一般應用程式相同。第一次啟動時，Cursor 會詢問是否要從既有的 VS Code 匯入設定，包含擴充套件、快捷鍵與主題。如果你原本就是 VS Code 使用者，強烈建議直接匯入，可以省下大量重新設定的時間。

登入帳號後，進入設定頁面，有幾個關鍵項目建議先調整：

模型選擇

Cursor 支援多種底層模型。一般日常補全與小修改，用速度較快的模型即可；遇到複雜的跨檔案重構或架構設計，再切換到能力較強的模型。養成「依任務難度切換模型」的習慣，能同時兼顧速度與品質。

隱私模式

如果你處理的是公司或客戶的敏感程式碼，務必到設定中開啟 Privacy Mode。開啟後，你的程式碼不會被用於訓練，這對商業專案是基本的合規要求。台灣許多接案與企業內部專案都有保密協議，這一步不能省略。

索引設定

Cursor 會對你的專案建立索引，讓 AI 理解檔案之間的關係。第一次開啟大型專案時，索引需要一點時間。你可以透過 .cursorignore 檔案排除不需要索引的目錄，例如 node_modules、建置產物或大型資料檔，加快索引速度並降低雜訊。

四個核心功能與快捷鍵

Cursor 的核心能力集中在四個功能上，熟練它們就能發揮八成戰力。

一、Tab 補全

最基礎但最常用的功能。當你開始輸入時，Cursor 會預測你接下來想寫的整段程式碼，按下 Tab 即可接受。它不只是補全單行，還能預測連續多行，甚至猜到你要跳去修改的下一個位置。剛開始可能會覺得補全太積極，用一陣子抓到節奏後，打字量會明顯下降。

二、Inline 編輯（Cmd/Ctrl + K）

選取一段程式碼後按下 Cmd + K，就能用自然語言下指令，例如「把這個 for 迴圈改成 map」或「加上錯誤處理」。Cursor 會直接在原地產生修改建議，你可以逐段接受或拒絕。這是做小範圍修改最快的方式。

三、Chat（Cmd/Ctrl + L）

開啟側邊聊天視窗，可以針對整個專案提問或討論。你可以用 @ 符號引用特定檔案、資料夾或符號，讓 AI 精準聚焦在你關心的範圍。例如輸入「@api/user.ts 這支 API 為什麼會回傳 500」，它就會讀取該檔案並分析。

四、Composer（Cmd/Ctrl + I）

Composer 是 Cursor 最強大的功能，專門處理跨多個檔案的任務。你可以描述一個較大的需求，例如「新增一個購物車頁面，包含元件、狀態管理與 API 串接」，Composer 會規劃要動哪些檔案、新增哪些檔案，並一次呈現所有變更讓你審查。這是從「補全工具」升級為「開發協作者」的關鍵功能。

實戰：用 Cursor 做出一個待辦清單應用

以下用一個具體流程示範完整開發過程。

第一步，先在 Chat 中描述整體目標：「我要做一個待辦清單網頁應用，用 React 加 TypeScript，功能包含新增、刪除、標記完成，資料存在瀏覽器的 localStorage。請先幫我規劃檔案結構。」讓 AI 先給出架構，你確認方向再往下。

第二步，切換到 Composer，貼上剛才確認的架構，請它一次建立骨架。審查產生的檔案時，重點看資料流是否合理、型別定義是否完整，而不是逐字讀每一行。

第三步，逐一功能細修。用 Inline 編輯把某個元件的樣式調整好，用 Chat 問「這段狀態更新為什麼畫面沒有重新渲染」。遇到 bug 時，把錯誤訊息直接貼進 Chat，它通常能定位問題。

第四步，收尾。請 Cursor 幫你補上邊界情況處理，例如空清單的顯示、輸入為空的驗證，並加上簡單的測試。

與既有專案整合的技巧

把 Cursor 導入已經存在的大型專案時，有幾個實用做法。

善用 Rules。在專案根目錄建立規則檔，寫下這個專案的慣例，例如「一律使用具名匯出」、「API 呼叫統一走 services 目錄」、「錯誤訊息用繁體中文」。這樣 AI 產生的程式碼會更貼近團隊風格，減少事後修改。

用 @ 精準給脈絡。不要讓 AI 猜，直接用 @ 引用相關檔案。給的脈絡越精準，產出品質越高，也越省 token。

小步快跑。不要一次要求它改動二十個檔案。拆成小任務，每個任務都能獨立審查與測試，出錯時也容易回溯。

常見錯誤與避坑

第一，盲目接受所有建議。AI 產生的程式碼看起來合理不代表正確。務必自己讀過、跑過、測過，尤其是牽涉金流、權限與資料刪除的邏輯。

第二，一次丟太大的需求。需求越模糊、範圍越大，AI 越容易產生看似完整但實際有洞的程式碼。把大需求拆小，是提升品質最有效的方法。

第三，忽略版本控制。用 AI 大量修改前，先確保 git 是乾淨的，這樣萬一改壞了可以立刻還原。這是使用任何 AI 編輯器的基本安全網。

第四，沒有設定 .cursorignore。讓 AI 索引到一堆無關檔案，不只慢，還會讓它的建議受到雜訊干擾。

小結

Cursor 的價值不在於「幫你打字」，而在於把它當成一位理解專案脈絡的協作者。熟練 Tab 補全、Inline 編輯、Chat 與 Composer 這四個核心功能，搭配 Rules 與精準的 @ 引用，並且始終保持審查與測試的習慣，你就能穩定產出可維護、可上線的程式碼。工具會進化，但「拆小任務、給準脈絡、自己驗證」這三個原則會一直有效。