《Cursor文檔》-終端設置

配置終端，獲得最佳的 Cursor 命令行界面使用體驗。本指南涵蓋多行輸入快捷鍵綁定、Vim 模式和主題同步。

快速開始¶

如果在終端中按 Shift+Enter 無法換行，請運行 /setup-terminal，瞭解如何配置替代方案：

/setup-terminal

此命令會檢測你的終端，並說明如何將 Option+Enter 配置爲另一種插入換行的方式。

通用選項¶

以下方法適用於所有終端，包括 tmux、screen 和 SSH 會話：

如果你正在使用 tmux，或其他快捷鍵綁定不起作用，Ctrl+J 是最可靠的選項。

終端支持¶

原生支持 Shift+Enter¶

以下終端原生支持使用 Shift+Enter 輸入換行：

• iTerm2 (macOS)
• Ghostty
• Kitty
• Warp
• Zed (集成終端)

需運行 /setup-terminal¶

這些終端需要運行 /setup-terminal，才能將 Option+Enter 配置爲輸入換行：

• Apple Terminal (macOS)
• Alacritty
• VS Code (集成終端)

終端多路複用器¶

tmux 和 screen 會在 Shift+Enter 傳遞給應用前將其攔截。請改用通用選項：

• Ctrl+J — 在所有終端多路複用器會話中都能穩定使用
• +Enter — 同樣在所有環境中可用

你可以將外層終端 (如 iTerm2) 配置爲使用 Shift+Enter，但該快捷鍵無法透過 tmux 傳遞。爲獲得最一致的體驗，請使用通用選項。

Vim 模式¶

在 CLI 輸入區域啓用 Vim 快捷鍵綁定，以便導航和編輯。

通過斜槓命令切換¶

/vim

這會在當前會話中啓用或關閉 Vim 模式，並保存該偏好設置。

在設置中配置¶

將以下內容添加到 ~/.cursor/cli-config.json：

{
  "version": 1,
  "editor": { "vimMode": true },
  "permissions": { "allow": [], "deny": [] }
}

模式¶

Vim 模式採用模態編輯：

• 普通模式 — 用於導航和執行命令 (啓用 Vim 模式時的默認模式)
• 插入模式 — 正常輸入文本

在插入模式下按 Esc 可返回普通模式。

導航¶

編輯¶

進入插入模式¶

計數¶

在命令前加上數字可重複執行命令。例如，3w 向前移動 3 個單詞，2dd 刪除 2 行。

Vim 模式僅影響輸入區域。瀏覽 chat 歷史記錄和其他 UI 元素時，使用標準快捷鍵綁定。

終端主題¶

Cursor 命令行界面會自動檢測終端的配色方案，並適配其外觀。

自動檢測¶

CLI 會使用標準轉義序列查詢終端的背景顏色。大多數現代終端都支持此功能：

• 深色終端 → CLI 使用深色主題
• 淺色終端 → CLI 使用淺色主題

支持自動檢測的終端¶

以下終端能正確報告其配色方案：

• iTerm2
• Ghostty
• Kitty
• Alacritty
• Apple Terminal
• Windows Terminal
• VS Code 集成終端

強制指定主題¶

如果自動檢測無效，您可以通過環境變量手動指定：

# 強制使用深色主題
export COLORFGBG="15;0"

# 強制使用淺色主題
export COLORFGBG="0;15"

將此內容添加到 shell 配置文件 (.bashrc、.zshrc 等) 中，使其永久生效。

主題問題疑難排查¶

顏色顯示不正常：

• 確保終端支持 256 色或真彩色
• 檢查 TERM 是否設置正確 (例如 xterm-256color)
• 嘗試顯式設置 COLORFGBG

tmux 用戶：

• 在 .tmux.conf 中添加以下內容，以正確檢測顏色：

  set -g default-terminal "tmux-256color"
  set -ag terminal-overrides ",xterm-256color:RGB"

• 更改後重新啓動 tmux

手動配置¶

如果 /setup-terminal 無法適用於您的終端，您可以手動配置快捷鍵綁定。

使用 Option+Enter 換行¶

Option+Enter 會發送一個特殊的轉義序列，Cursor 命令行界面 會將其識別爲換行。請將終端配置爲在按下 Option+Enter 時發送 \x1b\r (Escape 後接回車) 。

iTerm2：

1. 打開 偏好設置 → 配置文件 → 按鍵 → 按鍵映射
2. 點擊 + 添加新映射
3. 將 鍵盤快捷鍵 設置爲 Option+Enter
4. 將 操作 設置爲 “發送轉義序列”
5. 輸入 \r 作爲轉義序列

Alacritty：

將以下內容添加到 alacritty.toml：

[keyboard]
bindings = [
  { key = "Return", mods = "Alt", chars = "\u001b\r" }
]

Kitty：

將以下內容添加到你的 kitty.conf：

map alt+enter send_text all \x1b\r

Shift+Enter¶

是否支持 Shift+Enter 取決於終端能否正確識別該組合鍵的修飾鍵。大多數現代終端會自動處理，但有些可能需要配置。

VS Code 終端：

VS Code’s 集成終端可能無法正確傳遞 Shift+Enter。請在 keybindings.json 中添加以下內容：

{
  "key": "shift+enter",
  "command": "workbench.action.terminal.sendSequence",
  "args": { "text": "\u001b[13;2u" },
  "when": "terminalFocus"
}

疑難排查¶

快捷鍵綁定無效：

• 使用 cat 或 showkey 驗證終端能否正確識別按鍵
• 檢查終端多路複用器 (tmux/screen) 是否攔截了按鍵
• 使用 Ctrl+J 作爲可靠的備用方案

tmux 用戶：

• Shift+Enter 和 Option+Enter 無法在 tmux 中使用
• 請改用 Ctrl+J 或 +Enter
• 這些通用選項在任何環境下均可使用，包括嵌套的 tmux 會話

SSH 會話：

• 遠程終端功能取決於本地終端模擬器
• Ctrl+J 可通過 SSH 穩定使用
• +Enter 也是一個可靠的選項

摘要¶