---
title: "Windsurf 指令大全"
description: "收錄 100 個 Windsurf 功能、快捷鍵、Cascade、Command 與隱藏技巧"
source: https://aiterms.tw/cheatsheet/windsurf
version: "1.0.0"
lastUpdated: "2026-06-21"
---

# Windsurf 指令大全

> 收錄 100 個功能、快捷鍵、Cascade、Command 與隱藏技巧。
> 版本：1.0.0 | 更新：2026-06-21

## ⌨️ 鍵盤快捷鍵（Keyboard Shortcuts）

Windsurf / Devin Desktop 主要快捷鍵。

### `Cmd/Ctrl+L` : 開啟 Cascade（基礎）

開啟 Cascade，並自動帶入目前 editor 或 terminal 的選取內容。

### `Cmd/Ctrl+I` : 開啟 Command（基礎）

在編輯器中用自然語言直接生成或修改程式碼。

### `Cmd/Ctrl+Enter` : 提交 Command 指令（基礎）

在 Command 視窗內送出自然語言指令。

### `Cmd/Ctrl+Shift+A` : 開啟 Chat 面板（基礎）

開啟 chat panel，並在 editor 與 chat 之間切換焦點。

### `Cmd+Option+V / Ctrl+Alt+V` : Smart Paste（進階）

將剪貼簿內程式碼轉換成目標語言後貼入目前檔案。

### `Cmd+Enter` : 接受生成結果（基礎）

在 Command 生成完成後，將建議寫回編輯器並關閉 popup。

### `Cmd+Backspace` : 撤銷生成結果（進階）

還原到 Command 生成前的狀態，並保留剛剛的指令以便 follow-up。

## 🌊 Cascade 與 Chat Context（Cascade & Chat Context）

把 editor、terminal 與 chat context 串起來的高頻入口。

### `Terminal selection + Cmd/Ctrl+L` : 送 terminal 片段到 Cascade（基礎）

在 terminal 選取 stack trace 後送進 Cascade，作為下一個 prompt 的 context。

### `@terminal` : 在 Cascade 中引用 terminal（基礎）

讓 Cascade 直接理解目前 active terminals 與內容。

### `Web Search` : Web Search（基礎）

讓 Cascade 搜尋網頁資訊並在建議中引用。

## 🧠 規則與記憶（Rules & Memory）

Memories、Rules 與可持續客製化行為。

### `Rules` : Rules（進階）

使用規則系統來限制或引導 Cascade / Command 的行為。

### `Memories` : Memories（進階）

把穩定偏好或工作流存成記憶，降低每次重複說明的成本。

## 🛠️ Command / Cascade 模式（Command & Cascade Modes）

Command、Cascade、Chat 模式與各自適合的任務。

### `Cascade Code mode` : Code 模式（基礎）

適合要 Claude/Devin 主動改程式碼、呼叫工具與執行步驟時使用。

### `Cascade Chat mode` : Chat 模式（基礎）

適合先討論、分析與規劃，不急著直接改檔。

### `Command (file-scoped edits)` : Command 單檔編輯（基礎）

最適合做 file-scoped、inline 的自然語言修改，不消耗 premium credits。

### `請修正目前檔案，並說明你改了什麼。` : 修正：目前檔案（基礎）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。

### `請修正選取的程式碼，並說明你改了什麼。` : 修正：選取程式碼（基礎）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。

### `請修正這段 terminal error 與相關程式碼，並說明你改了什麼。` : 修正：terminal 錯誤（基礎）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。

### `請修正整個 workspace 的關聯與結構，並說明你改了什麼。` : 修正：整個 workspace（基礎）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。

### `請修正目前函式或 class，並說明你改了什麼。` : 修正：Code Lens 目標（基礎）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。

### `請修正這份 stack trace 與上下文，並說明你改了什麼。` : 修正：stack trace（基礎）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「修正」任務。

### `請針對目前檔案提出 3 步驟實作計畫。` : 做計畫：目前檔案（基礎）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。

### `請針對選取的程式碼提出 3 步驟實作計畫。` : 做計畫：選取程式碼（基礎）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。

### `請針對這段 terminal error 與相關程式碼提出 3 步驟實作計畫。` : 做計畫：terminal 錯誤（基礎）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。

### `請針對整個 workspace 的關聯與結構提出 3 步驟實作計畫。` : 做計畫：整個 workspace（基礎）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。

### `請針對目前函式或 class提出 3 步驟實作計畫。` : 做計畫：Code Lens 目標（基礎）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。

### `請針對這份 stack trace 與上下文提出 3 步驟實作計畫。` : 做計畫：stack trace（基礎）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「做計畫」任務。

### `請根據目前檔案推測 root cause。` : 除錯：目前檔案（進階）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。

### `請根據選取的程式碼推測 root cause。` : 除錯：選取程式碼（進階）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。

### `請根據這段 terminal error 與相關程式碼推測 root cause。` : 除錯：terminal 錯誤（進階）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。

### `請根據整個 workspace 的關聯與結構推測 root cause。` : 除錯：整個 workspace（進階）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。

### `請根據目前函式或 class推測 root cause。` : 除錯：Code Lens 目標（進階）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。

### `請根據這份 stack trace 與上下文推測 root cause。` : 除錯：stack trace（進階）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「除錯」任務。

## 🖥️ Terminal Control（Terminal Control）

Terminal 裡的 Command、Turbo mode、allow/deny list。

### `Terminal Command (Cmd/Ctrl+I)` : Terminal Command（基礎）

在 terminal 內把自然語言轉成 CLI syntax。

### `Turbo mode` : Turbo mode（進階）

讓 terminal 指令更偏向自動執行流程，而不是每一步都手動確認。

### `windsurf.cascadeCommandsAllowList` : Allow list（進階）

設定永遠自動放行的 terminal command stem，例如 `git`。

### `windsurf.cascadeCommandsDenyList` : Deny list（進階）

設定永遠不自動執行的 terminal command stem，例如 `rm`。

### `請為目前檔案加入最小可用的 logging 與 metrics。` : 加入觀測：目前檔案（進階）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。

### `請為選取的程式碼加入最小可用的 logging 與 metrics。` : 加入觀測：選取程式碼（進階）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。

### `請為這段 terminal error 與相關程式碼加入最小可用的 logging 與 metrics。` : 加入觀測：terminal 錯誤（進階）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。

### `請為整個 workspace 的關聯與結構加入最小可用的 logging 與 metrics。` : 加入觀測：整個 workspace（進階）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。

### `請為目前函式或 class加入最小可用的 logging 與 metrics。` : 加入觀測：Code Lens 目標（進階）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。

### `請為這份 stack trace 與上下文加入最小可用的 logging 與 metrics。` : 加入觀測：stack trace（進階）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「加入觀測」任務。

## 🔬 進階功能（Advanced Features）

Code Lenses、MCP、checkpoints、linter integration 等能力。

### `Code Lens: Explain` : Explain Code Lens（基礎）

在函式或 class 上方用 Code Lens 快速請 Cascade 解釋程式碼。

### `Code Lens: Refactor` : Refactor Code Lens（基礎）

直接對函式或 class 執行 refactor，相當於高精度的 scoped Command。

### `Code Lens: Docstring` : Docstring Code Lens（基礎）

為函式自動生成 docstring。

### `MCP` : MCP 整合（進階）

透過 MCP 把外部工具與資料源接進 Windsurf / Devin Desktop。

### `Checkpoints` : Checkpoints（進階）

在大型 agentic 任務中保留回退點，方便你快速比較或 rollback。

### `請替目前檔案補上測試。` : 補測試：目前檔案（基礎）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。

### `請替選取的程式碼補上測試。` : 補測試：選取程式碼（基礎）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。

### `請替這段 terminal error 與相關程式碼補上測試。` : 補測試：terminal 錯誤（基礎）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。

### `請替整個 workspace 的關聯與結構補上測試。` : 補測試：整個 workspace（基礎）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。

### `請替目前函式或 class補上測試。` : 補測試：Code Lens 目標（基礎）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。

### `請替這份 stack trace 與上下文補上測試。` : 補測試：stack trace（基礎）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「補測試」任務。

### `請重構目前檔案，維持原本行為不變。` : 重構：目前檔案（進階）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。

### `請重構選取的程式碼，維持原本行為不變。` : 重構：選取程式碼（進階）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。

### `請重構這段 terminal error 與相關程式碼，維持原本行為不變。` : 重構：terminal 錯誤（進階）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。

### `請重構整個 workspace 的關聯與結構，維持原本行為不變。` : 重構：整個 workspace（進階）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。

### `請重構目前函式或 class，維持原本行為不變。` : 重構：Code Lens 目標（進階）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。

### `請重構這份 stack trace 與上下文，維持原本行為不變。` : 重構：stack trace（進階）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「重構」任務。

### `請找出目前檔案最可能的效能瓶頸。` : 找效能瓶頸：目前檔案（進階）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。

### `請找出選取的程式碼最可能的效能瓶頸。` : 找效能瓶頸：選取程式碼（進階）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。

### `請找出這段 terminal error 與相關程式碼最可能的效能瓶頸。` : 找效能瓶頸：terminal 錯誤（進階）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。

### `請找出整個 workspace 的關聯與結構最可能的效能瓶頸。` : 找效能瓶頸：整個 workspace（進階）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。

### `請找出目前函式或 class最可能的效能瓶頸。` : 找效能瓶頸：Code Lens 目標（進階）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。

### `請找出這份 stack trace 與上下文最可能的效能瓶頸。` : 找效能瓶頸：stack trace（進階）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「找效能瓶頸」任務。

### `請對目前檔案做嚴格 code review。` : 做 code review：目前檔案（進階）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。

### `請對選取的程式碼做嚴格 code review。` : 做 code review：選取程式碼（進階）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。

### `請對這段 terminal error 與相關程式碼做嚴格 code review。` : 做 code review：terminal 錯誤（進階）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。

### `請對整個 workspace 的關聯與結構做嚴格 code review。` : 做 code review：整個 workspace（進階）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。

### `請對目前函式或 class做嚴格 code review。` : 做 code review：Code Lens 目標（進階）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。

### `請對這份 stack trace 與上下文做嚴格 code review。` : 做 code review：stack trace（進階）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「做 code review」任務。

## 💰 模型與信用（Models & Credits）

哪些功能消耗 premium credits、哪些不消耗。

### `Command = no premium credits` : Command 不耗 premium credits（基礎）

官方文件明確指出 Command 本身不消耗 premium model credits。

### `Devin Desktop Fast` : Fast model（基礎）

Command 預設使用針對 current-file edits 最佳化的 fast model。

## 💡 隱藏技巧（Power User Tips）

Smart Paste、stack trace handoff 與 file-scoped 編輯技巧。

### `Follow-up in Command` : 連續追問同一次生成（進階）

在 Command 生成之後直接追加 follow-up，會先撤掉目前結果再用累積指令重跑。

### `Code Lenses / @ Mentions for scoping` : 先縮 scope 再問（進階）

官方最佳實務建議用 Code Lenses 或 @ mentions 做精準 scoping，避免 context length 不夠。

### `請解釋目前檔案的邏輯與資料流。` : 解釋：目前檔案（基礎）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。

### `請解釋選取的程式碼的邏輯與資料流。` : 解釋：選取程式碼（基礎）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。

### `請解釋這段 terminal error 與相關程式碼的邏輯與資料流。` : 解釋：terminal 錯誤（基礎）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。

### `請解釋整個 workspace 的關聯與結構的邏輯與資料流。` : 解釋：整個 workspace（基礎）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。

### `請解釋目前函式或 class的邏輯與資料流。` : 解釋：Code Lens 目標（基礎）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。

### `請解釋這份 stack trace 與上下文的邏輯與資料流。` : 解釋：stack trace（基礎）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「解釋」任務。

### `請幫我縮小目前檔案的修改範圍。` : 縮小範圍：目前檔案（進階）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。

### `請幫我縮小選取的程式碼的修改範圍。` : 縮小範圍：選取程式碼（進階）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。

### `請幫我縮小這段 terminal error 與相關程式碼的修改範圍。` : 縮小範圍：terminal 錯誤（進階）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。

### `請幫我縮小整個 workspace 的關聯與結構的修改範圍。` : 縮小範圍：整個 workspace（進階）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。

### `請幫我縮小目前函式或 class的修改範圍。` : 縮小範圍：Code Lens 目標（進階）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。

### `請幫我縮小這份 stack trace 與上下文的修改範圍。` : 縮小範圍：stack trace（進階）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「縮小範圍」任務。

### `請比較目前檔案的兩種修法。` : 比較方案：目前檔案（進階）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。

### `請比較選取的程式碼的兩種修法。` : 比較方案：選取程式碼（進階）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。

### `請比較這段 terminal error 與相關程式碼的兩種修法。` : 比較方案：terminal 錯誤（進階）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。

### `請比較整個 workspace 的關聯與結構的兩種修法。` : 比較方案：整個 workspace（進階）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。

### `請比較目前函式或 class的兩種修法。` : 比較方案：Code Lens 目標（進階）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。

### `請比較這份 stack trace 與上下文的兩種修法。` : 比較方案：stack trace（進階）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「比較方案」任務。

### `請把目前檔案整理成團隊文件。` : 文件化：目前檔案（基礎）

把 目前檔案 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。

### `請把選取的程式碼整理成團隊文件。` : 文件化：選取程式碼（基礎）

把 選取程式碼 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。

### `請把這段 terminal error 與相關程式碼整理成團隊文件。` : 文件化：terminal 錯誤（基礎）

把 terminal 錯誤 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。

### `請把整個 workspace 的關聯與結構整理成團隊文件。` : 文件化：整個 workspace（基礎）

把 整個 workspace 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。

### `請把目前函式或 class整理成團隊文件。` : 文件化：Code Lens 目標（基礎）

把 Code Lens 目標 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。

### `請把這份 stack trace 與上下文整理成團隊文件。` : 文件化：stack trace（基礎）

把 stack trace 送進 Windsurf 的 Cascade / Command，要求它完成「文件化」任務。

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