AI 工具速查

Cursor 指令大全

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

112 個指令 8 個分類 更新:2026-04-22
目錄:8 個分類

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 提問

在 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
基礎
生成測試 斜線指令: 為選取的程式碼生成單元測試

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

.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、Composer、Agent 模式與相關操作

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

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

Bug Finder
NEW 進階
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 補全、行內編輯、差異預覽等智慧輸入功能

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
進階
強化差異顯示 啟用強化差異顯示設定,提升程式碼變更的可讀性

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

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

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

Hobby (Free)
基礎
免費方案 免費方案:包含有限的 Agent requests 與 Tab 補全,適合體驗

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

Pro ($20/月)
基礎
Pro 方案 Pro 方案:每月 $20 USD,適合個人開發者;提供完整 Agent 與 Tab 補全
Pro+ ($60/月)
基礎
Pro+ 方案 Pro+ 方案:每月 $60 USD,提供更高 Agent 用量與進階模型額度
Ultra ($200/月)
基礎
Ultra 方案 Ultra 方案:每月 $200 USD,最高用量與最先進模型存取
Teams ($40/user/月)
基礎
團隊方案 團隊方案:每人每月 $40 USD,含管理後台、集中計費、組織政策
Enterprise (Custom)
進階
企業方案 Enterprise 方案:客製化定價,含 SSO、SAML、進階安全與合規
Credit System
進階
信用點數 按模型與請求類型消耗點數,進階模型消耗較快
Model Auto-select
基礎
自動選模型 AI 根據任務複雜度自動選擇最佳模型,平衡速度與品質
Cmd+/ Model Cycle
基礎
手動切換 用 Cmd+/ 手動循環切換可用模型
Slow Pool
進階
降速佇列 高需求時段進入降速佇列,回應速度變慢但仍可使用

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

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 方案免費,提供 code completions 與少量 premium 請求。不需信用卡。適合輕度體驗,日常開發建議升級 Pro。

資料來源

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