本文根據 Cursor 官方文檔(Quickstart、幫助中心安裝與遷移頁)和 VS Code 官方文檔的顯示語言一節整理,資料核對於 2026-10-11。Cursor 更新很快,選單位置以你安裝的版本為準。
適用於誰
- 第一次裝 Cursor,想知道系統要求和安裝步驟的人;
- 搜「cursor 安裝教學」「cursor 設定中文」「cursor 設定中文不生效」的人;
- 已經在用 VS Code,想把插件、主題、快捷鍵一起搬過來的人。
Cursor 是什麼、適合誰,見本站 AI 應用目錄裏的 Cursor 條目;本文只講安裝和初始設定。
結論先說
- 只從官網下載:cursor.com/download。官方文檔要求 macOS 12 及以上、Windows 10 及以上;Linux 推薦用 apt / dnf 軟件源,其次才是 AppImage。
- 裝好後用 Cursor 帳號登入,再用 File → Open Folder 打開一個項目文件夾就能開始。
- VS Code 的擴展、主題、設定、快捷鍵可以一鍵導入:Cursor Settings → General → Account → VS Code Import。
- 「設定中文」其實是兩件事:介面語言沿用 VS Code 的語言包機制(命令面板裏的 Configure Display Language);讓 AI 用中文回答要寫進 User Rules。
- 官方文檔本身有簡體中文版:把文檔地址裏的
/docs換成/cn/docs即可。
步驟一:下載與安裝
| 系統 | 官方要求 | 安裝方式 |
|---|---|---|
| macOS | macOS 12(Monterey)及以上,支持 Apple 芯片和 Intel | 下載 .dmg,把 Cursor 拖進「應用程式」 |
| Windows | Windows 10 及以上 | 下載 .exe,按提示安裝 |
| Linux | — | apt(Debian / Ubuntu)或 dnf(RHEL / Fedora)軟件源;也可下載 AppImage |
Linux 用 AppImage 時:
bash
chmod +x Cursor-*.AppImage
./Cursor-*.AppImage
官方說明 apt / dnf 包優於 AppImage:有桌面圖標、自動更新,並且自帶命令行工具。軟件源的添加命令比較長,直接照官方 Quickstart 頁複製,不要從第三方頁面抄。
步驟二:登入並打開項目
- 打開 Cursor,按提示登入帳號(沒有帳號先在 cursor.com 免費註冊)。
- File → Open Folder,選一個已有的項目文件夾。
- 按
Ctrl+I(macOS 為Cmd+I)打開 Agent 面板,官方建議的第一句話是讓它講解代碼庫:
text
解釋這個代碼庫:主要入口在哪、有哪些關鍵模組、改代碼之前我應該先讀什麼?
- 第一次改動選低風險的小任務(改文案、修一個小介面問題),改完看 diff,再讓它跑項目已有的測試或類型檢查。
步驟三:從 VS Code 搬家
- 打開 Cursor Settings:
Ctrl+Shift+J(macOS 為Cmd+Shift+J); - 進入 General → Account;
- 在 VS Code Import 下點 Import。
擴展、主題、設定和快捷鍵會一起導入。要注意官方的一句提醒:Cursor 的擴展來自 Open VSX 而不是微軟的 VS Code Marketplace,常用擴展大多有,但不保證每個都在、行為完全一致。兩個編輯器可以同時安裝、打開同一個項目,互不影響。
步驟四:把介面改成中文
Cursor 的編輯器部分沿用 VS Code,顯示語言走的是 VS Code 的語言包機制(VS Code 官方文檔的說法是:預設英文,其他語言靠 Language Pack 擴展):
Ctrl+Shift+P(macOS 為Cmd+Shift+P)打開命令面板;- 輸入
display,選 Configure Display Language; - 選「中文(簡體)」;沒裝語言包時會先安裝;
- 按提示重啟。
如果列表裏沒有中文,先到擴展面板(Ctrl+Shift+X)搜尋 Chinese (Simplified) 語言包安裝,再重複上面的步驟。
「設定了不生效」常見原因:沒有完全重啟(要徹底退出再開,而不是隻關窗口);或者你看的是 Cursor 自己新增的介面。語言包翻譯的是編輯器原有的選單,Cursor Settings、Agents Window 這類 Cursor 自有面板是否漢化,官方文檔沒有承諾,保持英文屬於正常情況。
步驟五:讓 AI 用中文回答
介面語言不影響 AI 的回答語言。官方的做法是寫 User Rules(對所有項目生效的個人規則):打開側邊欄的 Customize → Rules,在 User Rules 裏加一句:
text
始終用簡體中文回答;代碼、命令和報錯原文保持英文。
注意官方文檔寫明:User Rules 只對 Agent(聊天)生效,不作用於行內編輯(Ctrl+K)和 Tab 補全。行內編輯想要中文解釋,就在指令裏直接寫「用中文說明」。項目級規則的寫法見《Cursor Rules 怎麼寫》。
常見問題
Q:啟動後白屏?
官方給的順序:完全退出再打開(macOS 用 Cmd+Q,Windows / Linux 從托盤退出);Windows 試試以管理員身份運行;macOS 把 Cursor 拖進廢紙簍後從官網重新下載。
Q:macOS 提示「Cursor 已損壞」?
官方說明這是 macOS 的問題,不是下載壞了。先退出 Cursor 並在「活動監視器」裏結束殘留進程,等一分鐘再開;不行就刪掉重新下載,再不行重啟電腦。
Q:怎麼更新?
命令面板輸入 Cursor: Attempt Update,按提示重啟。更新通道有 Stable(預設)和 Early Access(嚐鮮版,可能不穩定),在 Cursor Settings 裏切換。
Q:Cursor 越用越佔硬碟?
官方說最佔空間的通常是 Agent 的歷史對話。在命令面板裏先運行 Delete Old Chats… 選保留天數,再運行 GC Agent KV Blobs——第二條才會真正把數據庫文件縮小。
Q:免費能用嗎?
能。Hobby 免費檔可以用 Agent 和 Tab,但用量有限,詳見《Cursor 額度與套餐》。
參考資料
- Cursor Quickstart(官方):https://cursor.com/docs/get-started/quickstart
- Download and install Cursor(官方幫助中心):https://cursor.com/help/getting-started/install
- Migrate from VS Code(官方幫助中心):https://cursor.com/help/getting-started/migrate-vscode
- Installation and startup(官方幫助中心):https://cursor.com/help/troubleshooting/install-issues
- Rules(官方):https://cursor.com/docs/rules
- VS Code Display Language(微軟官方):https://code.visualstudio.com/docs/configure/locales
0 條評論
還沒有評論,來搶沙發~