網誌 · Cursor 使用指南 · 發佈
Cursor 怎麼開始用:下載、登入與第一個專案
按 Cursor 官方快速入門整理下載、登入與第一個專案的順序:各系統該取哪種安裝包、登入後要確認什麼、用 Cmd/Ctrl+I 開啟 Agent 先解釋程式碼庫,再做一個小改動、看 diff 並執行專案原有的檢查;任務跨多個檔案、需要先做調研或需要你先批准時,用 Plan Mode。文中給出下載對照表、Plan Mode 的適用判斷與卡住時的五步排查,並說明不建議使用第三方打包的安裝包。
第一次用 Cursor,按官方快速入門的順序走,步驟是清楚的:從下載頁取對應系統的安裝包,開啟應用程式登入,選一個資料夾,用 Cmd+I(macOS)或 Ctrl+I(Windows、Linux)開啟 Agent(智慧代理,能自己讀專案檔案、改程式碼的助手),先讓它解釋這個程式碼庫,再做一個小改動,最後看 diff(差異檢視,逐行標出新增、刪除與修改的行)並執行專案原本在用的檢查(Cursor 快速入門)。第一次不必從重寫整個模組開始,官方舉的低風險例子是改文案、修小介面這類改動;跨多個檔案、需要先做調研,或需要你先批准再寫程式碼時,適合先按 Shift+Tab 切到 Plan Mode(計畫模式)拿一份計畫。
一、下載:先按系統對一遍安裝包
官方把下載清單按系統分開,差別不只在安裝包副檔名:
| 系統 | 官方寫明的版本要求 | 安裝包形式 | 頁面另註明的資訊 |
|---|---|---|---|
| macOS | macOS 12(Monterey)及以上 | 原生安裝包(.dmg) | Apple Silicon 與 Intel 都支援 |
| Windows | Windows 10 及以上 | 原生安裝包(.exe) | 該頁未另列其他要求 |
| Debian / Ubuntu | 該頁未另列 | apt 套件庫 | 頁面標註為推薦方式 |
| RHEL / Fedora | 該頁未另列 | dnf 套件庫 | 用官方給出的套件庫檔案安裝 |
| Linux 可攜版 | 該頁未另列 | AppImage | 先賦予執行權限再執行 |
原生安裝包(.dmg、.exe)是下載後雙擊、按系統提示裝好的常規方式,不經過軟體商店,也不需要額外的軟體來源。macOS 這一行只列了一個 .dmg,並註明兩種晶片都支援,所以不必再挑晶片版本。
Linux 那三行才需要做選擇。官方寫明 apt 與 yum 套件優先於 AppImage,理由是它們提供桌面圖示、自動更新與 CLI(命令列工具,能在終端機裡直接輸入命令呼叫 Cursor)。AppImage 按頁面標註是可攜版,下載後先用 chmod +x 加上執行權限,再直接執行;官方把自動更新這一條寫在 apt 與 yum 名下,沒有寫給 AppImage。
取得途徑也按這個分法:桌面安裝包從 cursor.com 的下載頁取,Linux 的套件庫位址在 downloads.cursor.com(Cursor 快速入門)。論壇、網路硬碟或教學附件裡的安裝包無法核對來源與改動,本篇不建議使用第三方打包的版本。
二、登入:官方只寫一步,你要確認兩件事
快速入門對登入只寫到「開啟應用程式並登入」這一步,然後就是選一個資料夾、從一個小任務開始。這一頁沒有再展開帳號類型、方案或計費;文件首頁把模型與定價收在 Models & Pricing 一欄,帳號與帳單問題則指向官方 Support 入口(Cursor 文件)。
所以第一次登入只需要確認兩件事:能進到應用程式主介面,能選中一個本機資料夾。這兩件都成立,就可以往下走;卡在這一步,先回官方下載頁核對系統版本,不建議改用第三方打包的安裝包。
介面和你看到的教學截圖對不上時,文件首頁另有 Changelog(更新記錄)入口,先去核對最近改了什麼,再判斷是不是自己點錯了。
三、第一個專案:先讓它講清楚,再讓它動手
選好資料夾後,用 Cmd+I 或 Ctrl+I 開啟 Agent。官方建議的第一個請求是讓它解釋這個程式碼庫:指出主要入口、關鍵模組,以及動手改之前應該先讀哪些檔案。它會搜尋儲存庫、讀取相關檔案,再把專案各部分怎麼拼起來總結給你。
有一個前提不能跳過:Agent 讀的是你選中的那個資料夾。目錄選錯,它講的就成了另一個專案,後面的改動也會落到錯誤的位置。所以第一步不是急著寫提示,而是先看專案欄裡的目錄名稱對不對。
提示用中文寫就行,把範圍、要它輸出什麼說清楚。官方給的兩個範例都是先說明要它做什麼,其中第二個還要求它說明取捨、並等你選擇之後再動手;下面這個範例另外加了一句「先不要改動檔案」,你可以按需要保留(假設示範,不是官方原話):
先不要改動任何檔案,通讀這個專案,告訴我入口在哪、核心模組有哪幾個、改程式碼之前必須先讀哪幾個檔案,無法確認的地方標出來。
四、第一個改動:小、能核對、能還原
看懂結構之後,讓它提幾個小而安全的改進並說明各自的取捨,你挑一個再讓它動手;如果你已經知道要什麼,就直接描述想要的結果。官方舉的低風險例子是改文案、修小的介面問題——範圍小,出問題時也好還原。
它動手時你會看到 diff,逐行標出新增、刪除和修改。官方在這一步的要求很具體:等它做完,先看 diff,再讓它執行專案本來就在用的檢查。這類檢查通常分四種,含義不一樣:
- 測試:跑一遍既有測試案例,看有沒有改壞;
- 型別檢查:看變數和資料的型別對不對得上;
- lint:程式碼規範檢查,管格式和易錯寫法;
- 本機建置:看專案能不能正常打包或啟動。
這一步把「看起來改對了」變成「跑過一遍」。diff 讓你看它到底動了哪幾行,檢查告訴你有沒有弄壞別的地方。兩樣都過,再談下一個任務;只過一樣,就先讓它解釋沒過的原因,別急著加需求。
五、任務變大:先切 Plan Mode 拿計畫
官方寫明 Plan Mode 適合三種任務:跨多個檔案、需要先做調研、或者要你先批准再寫程式碼。切換方式是在 Agent 輸入框按 Shift+Tab。進入後它不會馬上寫程式碼,而是按順序走:調研程式碼庫找出相關檔案,就需求提問,給出詳細的實施計畫,等你批准後再動手。
| 你手上的任務 | 建議模式 | 你會看到什麼 | 你要做什麼 |
|---|---|---|---|
| 改一句文案、調一處樣式 | 直接改 | 一份 diff | 看 diff、跑專案已有的檢查 |
| 涉及多個檔案的新功能或重構 | Plan Mode | 相關檔案、提問、實施計畫 | 回答提問、批准計畫 |
| 需求自己也說不清 | Plan Mode | 它反過來問你 | 先把需求答清楚再批准 |
最直接的判斷是這次改動會不會同時動到好幾處;如果任務還需要先做調研,或者需要你先批准再寫程式碼,也同樣適合用 Plan Mode。
六、卡住時按這個順序排查
按順序走,每一步都能得到一個明確答案:
- 裝不上:先核對系統版本(macOS 12 起、Windows 10 起);Linux 優先使用 apt 或 dnf 套件庫;AppImage 要先賦予執行權限才能執行。
- 打不開 Agent:macOS 用 Cmd+I,Windows 與 Linux 用 Ctrl+I。
- 改完不確定對不對:開啟 diff 逐行看,再讓它執行專案已有的測試、型別檢查、lint 或本機建置。
- 越改越亂:先停手,切到 Plan Mode 要一份計畫,批准之後再讓它動手。
- 帳號、計費以及文件沒涵蓋的問題:走文件首頁的 Models & Pricing 與 Support 兩個入口。
順序的道理是:裝錯、按錯鍵這類原因自己能確認,先排除;帳號與帳單要官方入口才能查,放在後面。
七、熟悉之後,把反覆交代的事寫成規則
快速入門的下一步裡列了 Rules:為專案寫長期生效的指令,不必每次重複說明。這不是上手必需的一步,等你在同一個專案裡反覆交代同一件事時再寫。文件首頁把自訂相關內容收在 Customize(自訂)一欄,可連接的工作流程列了 GitHub、GitLab、Azure DevOps、Bitbucket、JetBrains、Slack、Linear 等,用到哪一項再去看對應頁(Cursor 文件)。
八、想比較付費方案時,再看這裡
Cursor 的下載、登入和基本用法到這裡就齊了。本篇只回答上手問題,不比較價格;帳號與計費問題按文件首頁指向的官方 Support 處理。
本站是第三方代充服務,與 OpenAI 無關聯,只處理 ChatGPT 會員相關訂單,Cursor 不在服務範圍內(充值服務條款)。如果你同時想按用量比較 ChatGPT 方案、判斷要不要付費,可以看訂閱費用總覽;在售方案與價格見 ChatGPT 充值套餐,每次只充 1 個月、不自動扣款,人民幣成交價與 OpenAI 官方美元定價不是同一計算基準,不宜直接換算比較。