Cursor 入門：安裝、第一個 AI 修改與檢查差異
按官方文件走一次由登入到驗收的小修改流程
想用 Cursor 完成第一個 AI 修改，可以依照官方 Quickstart 的次序：安裝及登入、開啟一個專案資料夾、請 Agent 解釋程式、只改一個小地方，最後檢查差異和結果。本文按 2026-09-14 查閱的官方文件整理，適合懂少量 HTML 或程式碼、但未用過 AI 編輯器的人；這是文件教學，並非 TechLab 實測評分。
第一個目標可以很細，例如改按鈕文字。先完成一次看得懂、驗得到、退得回的修改，比同時要求登入、付款和資料庫功能容易掌握。以下把官方操作路徑與一個自行設計的 HTML 練習分開說明，毋須先接觸雲端代理或正式網站。
1. 安裝、登入，再開啟專案資料夾
到 Cursor 官方 Quickstart 按 Download Cursor，下載適合自己電腦的版本。安裝後開啟 app 並登入，再選取要處理的資料夾。官方頁列有 macOS、Windows 和 Linux 的安裝方式；Linux 使用者應跟隨頁面對應發行版的指令，不要混用不同套件管理器。
如果已有專案，先確認目前工作已經保存；如果用 Git，先查看現有變更，保留一個自己知道怎樣返回的版本。練習時可另建資料夾，避免碰到正在使用的正式專案。帳戶是否需要付費、可用模型及用量上限，應在自己的帳戶頁核對；完成本文練習毋須先假設某個付費方案一定必要。
沒有現成專案，可自行建立一個 index.html 檔案，內容如下。這是本文提供的簡單練習材料，不是 Cursor 自動產生的測試結果：
<!doctype html>
<html lang="zh-HK">
<meta charset="utf-8">
<title>第一個 AI 修改</title>
<h1>活動報名</h1>
<button type="button">送出</button>
</html>
先用瀏覽器開啟該檔案，記下目前顯示的標題和按鈕文字。這個版本就是修改前的對照；它只有畫面，並沒有把資料送到任何地方。
2. 開啟 Agent，先讓它解釋程式
官方 Quickstart 列出的 Agent 快捷鍵是 macOS 的 Cmd + I、Windows／Linux 的 Ctrl + I。開啟資料夾後可用快捷鍵叫出 Agent，再輸入：
先不要修改檔案。請解釋這個資料夾的用途，指出主要入口，
並告訴我按鈕文字在哪個檔案、哪個位置。
官方說明 Agent 會搜尋及閱讀相關檔案，再整理專案結構。對上述練習，你可以自己開啟 index.html 核對它指的位置；對較大的專案，就先從它列出的主要入口閱讀。若它的解釋與你看到的檔案不符，先補充正確範圍，毋須急於讓它改動。
這一步的重點是建立共同上下文。檔案名稱、目前畫面及你想改的結果都寫清楚，下一步的要求才不容易變成「幫我改善整個網站」。
3. 提出一個有明確驗收條件的小修改
確認 Agent 找到正確位置後，可輸入以下練習要求：
只修改 index.html，把按鈕文字由「送出」改成「確認報名」。
保持標題、按鈕類型和其他內容原樣，不新增檔案或套件。
完成後說明改了哪一行。
驗收：瀏覽器重新載入後，按鈕顯示「確認報名」。
這段要求包含四件事：檔案範圍、要改的內容、不應改的部分，以及完成後應看見甚麼。它是本文設計的練習，不代表模型每次都會照做；因此下一步仍要檢查實際差異。
官方 Quickstart 建議先做細小修改。如果工作橫跨多個檔案，可以先用 Plan Mode 把工作拆開；官方目前列出的切換方式是在 Agent 輸入區按 Shift + Tab。第一次練習只改文字便足夠，先不要把整個專案重整成另一套框架。
4. 檢查 diff，再驗證畫面
Agent 完成後，閱讀 diff，即檔案修改前後的差異。這個練習應只涉及按鈕中的文字；如果出現新增套件、網絡請求或其他檔案變更，先逐項查明原因。不要因為回覆寫着「完成」便略過檔案本身。
然後重新載入瀏覽器，確認按鈕顯示「確認報名」，標題仍是「活動報名」。你也可以再次打開檔案核對：按鈕仍為 type="button"，沒有多出提交到外部的功能。這些是本例的驗收條件，不是對 Cursor 的準確率保證。
對真正專案，則執行原本已有的檢查，例如測試、type checker、lint 或本機 build。官方的 Reviewing and Testing Code 指出，AI 產生的程式即使能編譯，也可能遺漏邊界情況或產生不必要的重複；核對工作應沿用專案原有標準。
5. 不滿意就返回已知版本，再縮小要求
如果改動超出範圍，先停止追加功能。對本文的小練習，可以用事先保存的檔案還原；有 Git 的專案則按自己的版本管理流程處理，先檢查是否混有其他尚未保存的工作。不要盲目執行會丟棄全部修改的指令。
官方 Agent Security 說明，Agent 的檔案變更會直接保存到磁碟；如果專案開了自動重新載入，修改可能在你檢查前已經執行。因此，練習用獨立資料夾很有價值，也不能把「之後看 diff」當成所有情況下都未曾執行的保證。
不要把正式帳戶憑證或私人金鑰放進本次練習。遇到要求執行的指令，先讀清楚用途及影響範圍；看不懂時先要求解釋，再決定怎樣處理。
完成第一課後，可以怎樣繼續？
如果你能說出修改了哪個檔案、為甚麼只需那一行，以及怎樣驗證和還原，就已完成第一次有界限的 AI 協作。下一個練習可改成調整一個 CSS 顏色，或為已有函式補一個明確反例；每次仍保留相同的修改前對照和驗收條件。
這篇先處理安裝至第一次修改。模型速度、不同方案是否划算，以及複雜專案能否自動完成，需要另一套資料和實際測試，不能由一次入門流程推斷。
延伸閱讀
AI 輔助說明： 本文由 AI 協助整理，並經兩輪獨立自動品質審核；操作依官方文件說明，並非 TechLab 親手測試的結果。
