# Cursor 指令大全

> 收錄超過 111 個功能、快捷鍵、指令與隱藏技巧。
> 版本：1.0.0 | 更新：2026-04-22

## ⌨️ 鍵盤快捷鍵（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 提問

## 📎 @ 指令與斜線指令（@ 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` : 生成測試（基礎）

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

## ⚙️ 設定與規則（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 與 Composer（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 自動完成（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` : 強化差異顯示（進階）

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

## 🔬 進階功能（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` : 符號導航（基礎）

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

## 💰 模型與方案（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` : 降速佇列（進階）

高需求時段進入降速佇列，回應速度變慢但仍可使用

## 💡 隱藏技巧（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，攔截潛在問題

---
來源：AITerms.tw | https://aiterms.tw/cheatsheet/cursor