Cursor 指令大全

113 條

Cursor 指令大全收錄 Cursor IDE 快捷鍵、@ 指令、Agent Mode、Rules、MCP 與 Cloud agents,以繁體中文說明每個功能的用法。

共 113 條

鍵盤快捷鍵

  • 開啟 AI 編輯推薦

    開啟 AI 編輯面板,進行行內修改或多檔案任務

    Cmd+I
  • 開啟 Chat推薦

    開啟側邊欄 Chat 面板,與 AI 進行問答對話

    Cmd+L
  • 行內編輯推薦

    在游標位置開啟行內 AI 編輯提示框

    Cmd+K
  • 模式選單推薦

    開啟模式選單,快速切換 Chat、Agent 與計畫流程

    Cmd+.
  • 切換模型

    在 Chat 或 Agent 中快速切換 AI 模型

    Cmd+/
  • 命令面板

    開啟命令面板,搜尋並執行所有可用指令

    Cmd+Shift+P
  • 接受建議推薦

    接受 Tab 自動完成的灰色文字建議

    Tab
  • 拒絕建議

    拒絕目前顯示的 AI 建議或關閉彈窗

    Esc
  • 逐字接受

    逐字接受 Tab 建議,精確控制採納範圍

    Ctrl+Right Arrow
  • 終端機指令推薦

    在終端機中用自然語言生成 shell 指令

    Cmd+K (Terminal)
  • 立即執行

    立即執行終端機中生成的指令

    Cmd+Return
  • 跳到定義

    跳轉到游標下符號的定義位置

    F12
  • 預覽定義

    在行內彈窗中預覽符號定義,不離開當前位置

    Alt+F12
  • 尋找引用

    尋找游標下符號的所有引用位置

    Shift+F12
  • 重新命名

    重新命名符號,自動更新所有引用處

    F2
  • 選取加 context

    將選取的程式碼加入 Chat 作為 context 引用

    Cmd+Shift+L
  • 讀取策略

    切換檔案讀取策略,控制 AI 如何讀取檔案內容

    Cmd+M
  • 搜尋相似碼

    選取程式碼後搜尋程式碼庫中的相似片段

    Cmd+Return (選取)
  • 取消變更

    取消 AI 產生的變更,回復到編輯前狀態

    Cmd+Shift+Backspace
  • 旋轉切換

    在 AI 面板中旋轉切換不同互動模式

    Shift+Tab
  • 查看快捷鍵

    查看所有已設定的鍵盤快捷鍵列表

    Cmd+R → Cmd+S
  • 排隊訊息

    在 AI 回應期間排隊下一則訊息,完成後自動發送

    Ctrl+Return
  • 詢問選取

    針對選取的程式碼內容向 AI 提問

    Alt+Return

@ 指令與斜線指令

  • 引用檔案推薦

    引用特定檔案作為 AI 對話的 context

    @Files
  • 引用資料夾

    引用整個資料夾的結構與內容作為 context

    @Folders
  • 引用程式碼

    引用特定程式碼片段作為 context

    @Code
  • 程式庫搜尋推薦

    透過語意搜尋整個程式碼庫,找到最相關的 context

    @Codebase
  • 官方文件

    引用已設定的官方文件作為 AI 回答的參考依據

    @Docs
  • 網頁搜尋

    搜尋網頁資訊,取得最新的線上內容作為 context

    @Web
  • 未提交變更

    引用目前未提交的 Git 變更作為 context

    @Commit
  • 分支比較

    比較目前分支與主分支的差異,引用為 context

    @Branch
  • 附近定義

    自動附加游標附近的型別定義與函式簽名

    @Definitions
  • Lint 錯誤

    引用目前檔案的 lint 錯誤,讓 AI 協助修復

    @Lint Errors
  • 歷史對話

    引用過去的對話摘要,延續之前的討論脈絡

    @Past Chats
  • 引用規則

    引用已設定的 Cursor Rules 作為 context

    @Cursor Rules
  • 加入檔案

    用 # 語法將檔案加入 context,與 @Files 類似

    #Files
  • 編輯程式碼

    斜線指令: 編輯選取的程式碼區塊

    /edit
  • 修復問題

    斜線指令: 修復選取程式碼中的問題或錯誤

    /fix
  • 生成測試

    斜線指令: 為選取的程式碼生成單元測試

    /test

設定與規則

  • 專案規則

    把專案規範拆成可版本控制的多檔規則,讓 Agent 依任務套用上下文

    Project Rules
  • 新版規則目錄推薦

    新版專案規則目錄,支援多檔案規則與條件觸發

    .cursor/rules/
  • 全域規則

    在設定中配置全域使用者規則,套用到所有專案

    Settings > Rules
  • 團隊規則

    由團隊集中管理共享規則,讓多位工程師與 Agent 套用同一套工作標準

    Team Rules
  • 排除 AI 存取

    排除特定檔案或目錄,防止 AI 讀取敏感內容

    .cursorignore
  • 排除索引

    排除特定檔案不被程式碼庫索引,減少雜訊

    .cursorindexingignore
  • 自訂模式

    建立自訂代理模式,定義特定工具與行為組合

    Custom Modes
  • 模型設定

    啟用或停用可用的 AI 模型,管理模型偏好

    Settings > Models
  • MCP 設定

    設定 Model Context Protocol 伺服器連線

    Settings > Chat > MCP
  • 文件設定

    設定 @Docs 可引用的官方文件來源

    Settings > Features > Docs
  • 差異顯示

    設定程式碼差異的顯示方式: 並排或行內

    Diff Display Settings
  • 快捷鍵自訂

    自訂鍵盤快捷鍵,覆蓋預設綁定

    Keybinding Customization

Chat 與 Agent

  • 側邊欄對話

    側邊欄 Chat 面板,適合問答與被動式互動

    Chat (Cmd+L)
  • AI 編輯面板

    用 AI 編輯面板處理行內修改、多檔案任務與 Agent 工作流

    AI Edit / Agent (Cmd+I)
  • Agent 模式推薦

    最自主的模式: 自動拉取 context、執行指令、多步驟推理

    Agent Mode (Cmd+.)
  • 一般模式

    精確控制模式,AI 只回應明確指示,不主動執行

    Normal Mode
  • YOLO 模式

    自動執行終端指令,不需逐一確認,適合快速迭代

    啟用後 Agent 會自動執行 shell 指令,請確保在安全環境中使用

    YOLO Mode
  • Bug 偵測

    自動掃描程式碼庫,偵測潛在的 bug 與問題

    Bug Finder
  • 行內提示

    在游標位置用自然語言提示生成或修改程式碼

    Inline Edit (Cmd+K)
  • 終端機生成

    在整合終端機中用自然語言生成 shell 指令

    Terminal Cmd+K
  • 差異審查

    審查 AI 產生的程式碼差異,逐一接受或拒絕變更

    Diff Review
  • 全部接受

    一次接受 AI 產生的所有程式碼變更

    Accept All
  • 全部拒絕

    一次拒絕 AI 產生的所有程式碼變更

    Reject All
  • AI 提交訊息

    AI 根據程式碼變更自動生成 Git 提交訊息

    AI Commit Message
  • 合併衝突

    AI 協助解決 Git 合併衝突,智慧選擇保留內容

    Merge Conflict Resolution

Tab 自動完成

  • Tab 補全

    灰色文字建議: 按 Tab 插入 AI 預測的程式碼片段

    Tab Completion
  • 差異彈窗

    右側彈窗顯示修改建議,用於修改現有程式碼而非插入

    Diff Popup
  • 多行建議

    一次建議 5 到 10 行的多行程式碼修改

    Multi-line Suggestion
  • Linter 感知

    根據 linter 錯誤主動建議修復方案

    Linter-aware Suggestions
  • 近期編輯感知

    根據你近期的編輯動作改善後續建議的準確度

    Recent Changes Context
  • 部分接受

    按 Ctrl+右箭頭逐字接受建議,精細控制採納範圍

    Partial Accept (Ctrl+Right)
  • 打字覆蓋

    繼續打字即可覆蓋目前的 AI 建議,不需按 Esc

    Override by Typing
  • 生成新碼

    無選取文字時按 Cmd+K,在游標位置生成全新程式碼

    Cmd+K (無選取)
  • 修改選取碼

    選取程式碼後按 Cmd+K,用自然語言描述修改方式

    Cmd+K (有選取)
  • Context 排序

    AI 自動根據相關性排序 context,優先使用最相關的內容

    Context Ranking
  • 差異預覽

    接受變更前預覽完整的程式碼差異內容

    Diff Preview
  • 強化差異顯示

    啟用強化差異顯示設定,提升程式碼變更的可讀性

    Enhanced Diff Display

進階功能

  • MCP 整合

    Model Context Protocol 整合,連接外部工具與資料來源

    MCP Integration
  • 程式庫索引

    基於 RAG 的程式碼庫索引,提升語意搜尋的準確度

    Codebase Indexing
  • 共享索引

    團隊共享程式碼庫索引,新成員不需重新建立索引

    Shared Indexing
  • 自動存檔

    每次 Agent 編輯前自動建立檢查點,可隨時回滾

    Checkpoints
  • 圖片 Context

    貼上截圖或拖入圖片,讓 AI 根據視覺內容生成程式碼

    Image Context
  • 檔案分塊

    大檔案自動分塊處理,避免超出 context 視窗限制

    File Chunking
  • 嵌入快取

    快取程式碼嵌入向量,加速後續的語意搜尋與索引

    Embedding Cache
  • 自訂代理模式

    建立自訂代理模式,限定可用工具與行為規則

    Custom Agent Modes
  • VS Code 外掛

    完整相容 VS Code 外掛生態系,可直接安裝使用

    VS Code Extensions
  • Git 整合

    內建 Git 整合: 提交、分支、合併、差異比較

    Git Integration
  • 符號導航

    快速跳轉到定義、引用、型別宣告等符號位置

    Symbol Navigation

模型與方案

  • 免費方案

    免費方案:包含有限的 Agent requests 與 Tab 補全,適合體驗

    官方未在定價頁列固定數字;實際額度以 cursor.com 為準

    Hobby (Free)
  • Pro 方案

    Pro 方案:每月 $20 USD,適合個人開發者;提供完整 Agent 與 Tab 補全

    Pro ($20/月)
  • Pro+ 方案

    Pro+ 方案:官方建議給 daily agent users,適合每天用 Agent 跑較長任務的人

    Pro+ (Individual)
  • Ultra 方案

    Ultra 方案:官方建議給 agent power users,適合高頻長任務與重度模型用量

    Ultra (Individual)
  • 團隊方案

    團隊方案:含 Standard / Premium,重點是集中計費、team marketplace、Cloud agents、analytics、privacy mode 與 SSO

    Teams ($40/user/月)
  • 企業方案

    Enterprise 方案:客製化定價,含 SSO、SAML、進階安全與合規

    Enterprise (Custom)
  • 用量計費

    內含 model usage 用完後可走 on-demand usage,依實際模型用量追加計費

    Usage-based Pricing
  • 自動選模型

    AI 根據任務複雜度自動選擇最佳模型,平衡速度與品質

    Model Auto-select
  • 手動切換

    用 Cmd+/ 手動循環切換可用模型

    Cmd+/ Model Cycle
  • 超額用量

    內含用量不足時,先評估是否開啟 on-demand usage,而不是只升更高方案

    On-demand Usage

隱藏技巧

  • 檢查點回滾

    利用自動檢查點安全回滾風險重構,不怕改壞程式碼

    Checkpoint Rollback
  • 截圖驅動開發

    貼上設計稿截圖讓 AI 直接生成對應的前端程式碼

    Screenshot-driven Development
  • 選擇性開檔

    只開啟相關檔案作為 context,減少雜訊提升 AI 準確度

    Selective Reference Editors
  • YOLO TypeScript

    YOLO 模式搭配 tsc: Agent 自動修復所有 TypeScript 錯誤

    YOLO + tsc Workflow
  • YOLO 測試

    YOLO 模式搭配 pytest: Agent 自動執行並修復失敗測試

    YOLO + pytest Workflow
  • 閃光提交

    在 Git 面板點擊閃光圖示,AI 自動生成提交訊息

    Commit Message Sparkle
  • 選取搜尋

    選取程式碼後按 Cmd+Return 搜尋程式庫中的相似片段

    Codebase Search from Selection
  • 規則團隊化

    將 Project Rules 與 Team Rules 納入版本控制與團隊治理,讓 Agent 輸出更一致

    Team Rules as Shared Asset
  • 文件引用

    設定常用框架文件,讓 AI 回答時自動參考官方文件

    @Docs Documentation
  • 索引範圍控制

    用 .cursorindexingignore 精確控制索引範圍,排除雜訊

    Codebase Indexing Control
  • MCP 外部服務

    透過 MCP 連接資料庫、API、檔案系統等外部服務

    MCP Server Connections
  • 關閉自動接受

    關閉自動接受功能,手動審查每個變更可減少約 70% 錯誤

    在 Settings > Features 中關閉 auto-accept,犧牲速度換取品質

    Disable Auto-accept
  • 強化差異模式

    啟用強化差異模式,更清楚地顯示 AI 修改的程式碼區域

    Enhanced Diff Mode
  • 讀取策略切換

    用 Cmd+M 切換檔案讀取策略,控制 AI 讀取深度與範圍

    File Reading Strategies (Cmd+M)
  • 提交前偵測

    提交程式碼前先執行 Bug Finder,攔截潛在問題

    Bug Finder Before Commit

怎麼用這一頁

如果你只是想快速上手 Cursor,先看快捷鍵、@ 指令與 Agent Mode 這三塊;要把它變成長期工作環境再看 Rules 與 MCP。這頁是速查用的,不是從頭教學。

可以直接輸入的內容(API 參數、斜線指令、提示詞範本)附複製鈕。鍵盤指令依原文使用,macOS(Cmd)與 Windows/Linux(Ctrl)的差異不會自動改寫。

常見比較

常見問題

下一步

其他工具的指令大全

資料來源

Cursor 持續更新中,建議搭配官方文件使用。

其他格式:Markdown 版本