Cursor 指令大全

Cursor 指令大全收錄超過 111 個快捷鍵、@ 指令、Composer、Agent Mode 與隱藏技巧,以繁體中文說明每個功能的用法。

111 個功能 8 個分類 更新:2026-04-22
目錄:8 個分類
⌨️

鍵盤快捷鍵23

Keyboard Shortcuts

Cursor IDE 常用鍵盤組合快捷鍵

Cmd+I
基礎
開啟 Composer | 開啟 Composer 浮動面板,進行多檔案 AI 編輯
Cmd+L
基礎
開啟 Chat | 開啟側邊欄 Chat 面板,與 AI 進行問答對話
Cmd+K
基礎
行內編輯 | 在游標位置開啟行內 AI 編輯提示框
Cmd+.
基礎
模式選單 | 開啟模式選單,快速切換 Chat、Composer、Agent
Cmd+/
基礎
切換模型 | 在 Chat 或 Composer 中快速切換 AI 模型
Cmd+Shift+P
基礎
命令面板 | 開啟命令面板,搜尋並執行所有可用指令
Tab
基礎
接受建議 | 接受 Tab 自動完成的灰色文字建議
Esc
基礎
拒絕建議 | 拒絕目前顯示的 AI 建議或關閉彈窗
Ctrl+Right Arrow
進階
逐字接受 | 逐字接受 Tab 建議,精確控制採納範圍
Cmd+K (Terminal)
基礎
終端機指令 | 在終端機中用自然語言生成 shell 指令
Cmd+Return
基礎
立即執行 | 立即執行終端機中生成的指令
F12
基礎
跳到定義 | 跳轉到游標下符號的定義位置
Alt+F12
基礎
預覽定義 | 在行內彈窗中預覽符號定義,不離開當前位置
Shift+F12
基礎
尋找引用 | 尋找游標下符號的所有引用位置
F2
基礎
重新命名 | 重新命名符號,自動更新所有引用處
Cmd+Shift+L
進階
選取加 context | 將選取的程式碼加入 Chat 作為 context 引用
Cmd+M
進階
讀取策略 | 切換檔案讀取策略,控制 AI 如何讀取檔案內容
Cmd+Return (選取)
進階
搜尋相似碼 | 選取程式碼後搜尋程式碼庫中的相似片段
Cmd+Shift+Backspace
進階
取消變更 | 取消 AI 產生的變更,回復到編輯前狀態
Shift+Tab
進階
旋轉切換 | 在 Composer 中旋轉切換不同互動模式
Cmd+R → Cmd+S
基礎
查看快捷鍵 | 查看所有已設定的鍵盤快捷鍵列表
Ctrl+Return
進階
排隊訊息 | 在 AI 回應期間排隊下一則訊息,完成後自動發送
Alt+Return
進階
詢問選取 | 針對選取的程式碼內容向 AI 提問
📎

@ 指令與斜線指令16

@ Commands & Slash Commands

在 Chat 或 Composer 中引用 context 的 @ 指令與 / 指令

@Files
基礎
引用檔案 | 引用特定檔案作為 AI 對話的 context
@Folders
基礎
引用資料夾 | 引用整個資料夾的結構與內容作為 context
@Code
基礎
引用程式碼 | 引用特定程式碼片段作為 context
@Codebase
進階
程式庫搜尋 | 透過語意搜尋整個程式碼庫,找到最相關的 context
@Docs
進階
官方文件 | 引用已設定的官方文件作為 AI 回答的參考依據
@Web
進階
網頁搜尋 | 搜尋網頁資訊,取得最新的線上內容作為 context
@Commit
進階
未提交變更 | 引用目前未提交的 Git 變更作為 context
@Branch
進階
分支比較 | 比較目前分支與主分支的差異,引用為 context
@Definitions
進階
附近定義 | 自動附加游標附近的型別定義與函式簽名
@Lint Errors
進階
Lint 錯誤 | 引用目前檔案的 lint 錯誤,讓 AI 協助修復
@Past Chats
進階
歷史對話 | 引用過去的對話摘要,延續之前的討論脈絡
@Cursor Rules
進階
引用規則 | 引用已設定的 Cursor Rules 作為 context
#Files
基礎
加入檔案 | 用 # 語法將檔案加入 context,與 @Files 類似
/edit
基礎
編輯程式碼 | 斜線指令: 編輯選取的程式碼區塊
/fix
基礎
修復問題 | 斜線指令: 修復選取程式碼中的問題或錯誤
/test
基礎
生成測試 | 斜線指令: 為選取的程式碼生成單元測試
⚙️

設定與規則11

Rules & Configuration

專案規則、忽略檔案、自訂模式等設定

.cursorrules
基礎
舊版規則 | 舊版專案根目錄規則檔,仍然支援但建議遷移到新版
.cursor/rules/
基礎
新版規則目錄 | 新版專案規則目錄,支援多檔案規則與條件觸發
Settings > Rules
基礎
全域規則 | 在設定中配置全域使用者規則,套用到所有專案
.cursorignore
進階
排除 AI 存取 | 排除特定檔案或目錄,防止 AI 讀取敏感內容
.cursorindexingignore
進階
排除索引 | 排除特定檔案不被程式碼庫索引,減少雜訊
Custom Modes
進階
自訂模式 | 建立自訂代理模式,定義特定工具與行為組合
Settings > Models
基礎
模型設定 | 啟用或停用可用的 AI 模型,管理模型偏好
Settings > Chat > MCP
進階
MCP 設定 | 設定 Model Context Protocol 伺服器連線
Settings > Features > Docs
進階
文件設定 | 設定 @Docs 可引用的官方文件來源
Diff Display Settings
基礎
差異顯示 | 設定程式碼差異的顯示方式: 並排或行內
Keybinding Customization
基礎
快捷鍵自訂 | 自訂鍵盤快捷鍵,覆蓋預設綁定
🤖

Chat 與 Composer13

Chat, Composer & Agent

Chat、Composer、Agent 模式與相關操作

Chat (Cmd+L)
基礎
側邊欄對話 | 側邊欄 Chat 面板,適合問答與被動式互動
Composer (Cmd+I)
基礎
Composer 面板 | 浮動 Composer 面板,主動式多檔案 AI 編輯
Agent Mode (Cmd+.)
進階
Agent 模式 | 最自主的模式: 自動拉取 context、執行指令、多步驟推理
Normal Mode
基礎
一般模式 | 精確控制模式,AI 只回應明確指示,不主動執行
YOLO Mode
進階
YOLO 模式 | 自動執行終端指令,不需逐一確認,適合快速迭代

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

Bug Finder
進階
Bug 偵測 | 自動掃描程式碼庫,偵測潛在的 bug 與問題
Inline Edit (Cmd+K)
基礎
行內提示 | 在游標位置用自然語言提示生成或修改程式碼
Terminal Cmd+K
基礎
終端機生成 | 在整合終端機中用自然語言生成 shell 指令
Diff Review
基礎
差異審查 | 審查 AI 產生的程式碼差異,逐一接受或拒絕變更
Accept All
基礎
全部接受 | 一次接受 AI 產生的所有程式碼變更
Reject All
基礎
全部拒絕 | 一次拒絕 AI 產生的所有程式碼變更
AI Commit Message
基礎
AI 提交訊息 | AI 根據程式碼變更自動生成 Git 提交訊息
Merge Conflict Resolution
進階
合併衝突 | AI 協助解決 Git 合併衝突,智慧選擇保留內容

Tab 自動完成12

Tab Completion & Inline Edit

Tab 補全、行內編輯、差異預覽等智慧輸入功能

Tab Completion
基礎
Tab 補全 | 灰色文字建議: 按 Tab 插入 AI 預測的程式碼片段
Diff Popup
基礎
差異彈窗 | 右側彈窗顯示修改建議,用於修改現有程式碼而非插入
Multi-line Suggestion
進階
多行建議 | 一次建議 5 到 10 行的多行程式碼修改
Linter-aware Suggestions
進階
Linter 感知 | 根據 linter 錯誤主動建議修復方案
Recent Changes Context
進階
近期編輯感知 | 根據你近期的編輯動作改善後續建議的準確度
Partial Accept (Ctrl+Right)
進階
部分接受 | 按 Ctrl+右箭頭逐字接受建議,精細控制採納範圍
Override by Typing
基礎
打字覆蓋 | 繼續打字即可覆蓋目前的 AI 建議,不需按 Esc
Cmd+K (無選取)
基礎
生成新碼 | 無選取文字時按 Cmd+K,在游標位置生成全新程式碼
Cmd+K (有選取)
基礎
修改選取碼 | 選取程式碼後按 Cmd+K,用自然語言描述修改方式
Context Ranking
進階
Context 排序 | AI 自動根據相關性排序 context,優先使用最相關的內容
Diff Preview
基礎
差異預覽 | 接受變更前預覽完整的程式碼差異內容
Enhanced Diff Display
進階
強化差異顯示 | 啟用強化差異顯示設定,提升程式碼變更的可讀性
🔬

進階功能12

Advanced Features

MCP 整合、程式碼索引、語意搜尋、檢查點等進階能力

MCP Integration
進階
MCP 整合 | Model Context Protocol 整合,連接外部工具與資料來源
Codebase Indexing
進階
程式庫索引 | 基於 RAG 的程式碼庫索引,提升語意搜尋的準確度
Semantic Search
進階
語意搜尋 | 用自然語言搜尋程式碼庫,找到語意相關的程式碼片段
Shared Indexing
進階
共享索引 | 團隊共享程式碼庫索引,新成員不需重新建立索引
Checkpoints
進階
自動存檔 | 每次 Agent 編輯前自動建立檢查點,可隨時回滾
Image Context
進階
圖片 Context | 貼上截圖或拖入圖片,讓 AI 根據視覺內容生成程式碼
File Chunking
進階
檔案分塊 | 大檔案自動分塊處理,避免超出 context 視窗限制
Embedding Cache
進階
嵌入快取 | 快取程式碼嵌入向量,加速後續的語意搜尋與索引
Custom Agent Modes
進階
自訂代理模式 | 建立自訂代理模式,限定可用工具與行為規則
VS Code Extensions
基礎
VS Code 外掛 | 完整相容 VS Code 外掛生態系,可直接安裝使用
Git Integration
基礎
Git 整合 | 內建 Git 整合: 提交、分支、合併、差異比較
Symbol Navigation
基礎
符號導航 | 快速跳轉到定義、引用、型別宣告等符號位置
💰

模型與方案9

Models & Pricing

訂閱方案、信用點數制度與模型選擇

Hobby Plan
基礎
免費方案 | 免費方案: 2000 次補全 + 50 次進階請求,適合體驗
Pro Plan ($20/月)
基礎
Pro 方案 | Pro 方案: 每月 $20 信用點數池,適合個人開發者
Pro+ Plan ($40/月)
基礎
Pro+ 方案 | Pro+ 方案: 每月 $60 信用點數池,更多進階模型用量
Ultra Plan ($100/月)
基礎
Ultra 方案 | Ultra 方案: 每月 $200 信用點數池,無限制使用體驗
Business Plan ($40/seat/月)
基礎
Business 方案 | Business 方案: 每人每月 $40,含管理後台與集中計費
Credit System
進階
信用點數 | 按模型與請求類型消耗點數,進階模型消耗較快
Model Auto-select
基礎
自動選模型 | AI 根據任務複雜度自動選擇最佳模型,平衡速度與品質
Cmd+/ Model Cycle
基礎
手動切換 | 用 Cmd+/ 手動循環切換可用模型
Slow Pool
進階
降速佇列 | 高需求時段進入降速佇列,回應速度變慢但仍可使用
💡

隱藏技巧15

Hidden Tips & Power User

官方文件不一定提到的高效用法與進階技巧

Checkpoint Rollback
隱藏
檢查點回滾 | 利用自動檢查點安全回滾風險重構,不怕改壞程式碼
Screenshot-driven Development
隱藏
截圖驅動開發 | 貼上設計稿截圖讓 AI 直接生成對應的前端程式碼
Selective Reference Editors
隱藏
選擇性開檔 | 只開啟相關檔案作為 context,減少雜訊提升 AI 準確度
YOLO + tsc Workflow
隱藏
YOLO TypeScript | YOLO 模式搭配 tsc: Agent 自動修復所有 TypeScript 錯誤
範例
提示 Agent 執行 tsc --noEmit 並自動修復所有錯誤
YOLO + pytest Workflow
隱藏
YOLO 測試 | YOLO 模式搭配 pytest: Agent 自動執行並修復失敗測試
範例
提示 Agent 執行 pytest 並自動修復所有失敗的測試案例
Commit Message Sparkle
隱藏
閃光提交 | 在 Git 面板點擊閃光圖示,AI 自動生成提交訊息
Codebase Search from Selection
隱藏
選取搜尋 | 選取程式碼後按 Cmd+Return 搜尋程式庫中的相似片段
.cursorrules as Team Asset
隱藏
規則團隊化 | 將 .cursor/rules/ 加入版本控制,整個團隊共用 AI 規則
@Docs Documentation
隱藏
文件引用 | 設定常用框架文件,讓 AI 回答時自動參考官方文件
Codebase Indexing Control
隱藏
索引範圍控制 | 用 .cursorindexingignore 精確控制索引範圍,排除雜訊
MCP Server Connections
隱藏
MCP 外部服務 | 透過 MCP 連接資料庫、API、檔案系統等外部服務
Disable Auto-accept
隱藏
關閉自動接受 | 關閉自動接受功能,手動審查每個變更可減少約 70% 錯誤

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

Enhanced Diff Mode
隱藏
強化差異模式 | 啟用強化差異模式,更清楚地顯示 AI 修改的程式碼區域
File Reading Strategies (Cmd+M)
隱藏
讀取策略切換 | 用 Cmd+M 切換檔案讀取策略,控制 AI 讀取深度與範圍
Bug Finder Before Commit
隱藏
提交前偵測 | 提交程式碼前先執行 Bug Finder,攔截潛在問題

常見問題

Cursor 的核心快捷鍵有哪些?

Cmd+I 開啟 Composer(多檔編輯)、Cmd+L 開啟 Chat(問答)、Cmd+K 行內編輯、Cmd+. 切換模式(Chat/Composer/Agent)、Tab 接受建議、Cmd+/ 切換 AI 模型。

Cursor 的 Chat、Composer、Agent 有什麼差別?

Chat(Cmd+L)是被動問答模式。Composer(Cmd+I)是主動多檔編輯模式。Agent(Cmd+.)是最自主模式,自動拉 context、執行終端指令,最多 25 個工具呼叫。

Cursor 的 @ 指令有哪些?

@Files 引用檔案、@Folders 引用資料夾、@Codebase 搜尋程式碼庫、@Docs 查官方文件、@Web 搜網頁、@Commit 引用未提交變更、@Branch 比較分支等。

.cursorrules 怎麼設定?

新版建議用 .cursor/rules/ 目錄,每個規則一個檔案,可版本控制。寫法像百科全書條目,告訴 Cursor 要做什麼(而非避免什麼)。避免「你是資深工程師」等身份宣稱。

Cursor 的 Tab 自動完成有多強?

Tab 建議不只是插入,還能修改周圍程式碼。支援多行建議(一次改 5-10 行)、根據 linter 錯誤建議修復、根據近期編輯改善建議。Ctrl+Right Arrow 可逐字接受。

Cursor 的 YOLO Mode 是什麼?

YOLO Mode 讓 Agent 自動執行終端指令並修復錯誤。例如跑 tsc 後自動修 TypeScript 錯誤、跑 pytest 後自動修測試失敗。可在設定中配置允許/禁止清單。

Cursor 免費版有什麼限制?

Hobby 方案免費,提供 2000 次 code completions + 50 次 premium 請求。不需信用卡。適合輕度體驗,日常開發建議升級 Pro($20/月)。

資料來源

  • Cursor 官方文件:docs.cursor.com
  • 社群整理與實測驗證

本頁內容以 2026-04-22 版本為準。Cursor 持續更新中,建議搭配官方文件使用。