Skip to content

terminal_settings.zh TW

Jump to bottom
Weizhong Yang a.k.a zonble edited this page Aug 24, 2026 · 2 revisions

在終端機中啟用 Alt／Meta 鍵

zago 的 M+... 快捷鍵需要終端機把 Alt（macOS 上通常稱為 Option）送成 Meta 輸入。最相容的格式是 ESC prefix：例如 Alt+V 會送出 ESC 再 送出 v（\x1bv）。一般不要選擇舊式的 high-bit Meta 模式。

macOS

Ghostty

在 Ghostty 設定檔加入：

macos-option-as-alt = true

macOS 常見設定檔位置是：

~/Library/Application Support/com.mitchellh.ghostty/config.ghostty

也可以使用 ~/.config/ghostty/config.ghostty。修改後重新載入設定或重新 開啟 Ghostty。

參考：Ghostty 設定、 macos-option-as-alt。

cmux

若使用 cmux TUI 設定，請啟用 macOS Option-as-Alt 與 Alt 快捷鍵：

keys.macos_option_as_alt = true
keys.alt_shortcuts = true

如果 Option 被 macOS 當成特殊字元輸入，而沒有送到 zago，請先檢查 macos_option_as_alt。

參考：cmux TUI 設定。

iTerm2

  1. 開啟 Settings / Preferences → Profiles → Keys。
  2. 將 Left Option key 設為 Esc+。
  3. 如果右側 Option 也要作為 Meta，將 Right Option key 一併設為 Esc+。

Esc+ 會在字元前送出 ESC。一般不要選擇舊式的 high-bit Meta 模式。

參考：iTerm2 Profiles → Keys。

Windows

Windows Terminal

Windows Terminal 通常會直接將 Alt 當成終端機修飾鍵，不需要額外設定。如果 某個快捷鍵沒有傳到 zago：

  1. 開啟 Settings → Actions。
  2. 搜尋該組合鍵，例如 Alt+Left、Alt+Right 或 Alt+Up。
  3. 移除或修改會攔截該快捷鍵的 Windows Terminal action。
  4. 開啟新的終端分頁後重新測試。

重點是讓 Windows Terminal 將 Alt 序列轉送給終端程式，而不是自己拿去執行 分頁或視窗操作。

Linux

圖形介面終端機

GNOME Terminal、Konsole、xterm，以及大多數 X11／Wayland 終端模擬器，預設 通常已經會把 Alt／Meta 送成 ESC prefix。如果終端機提供 Meta sends Escape、Alt sends Escape 或類似選項，請將它開啟。

xterm 可以使用：

xterm -xrm 'XTerm*metaSendsEscape: true'

Konsole 則可到 Settings → Edit Current Profile → Keyboard 檢查，確定自訂 快捷鍵沒有攔截 zago 的 Alt 組合鍵。

參考：xterm Meta Sends Escape、 Konsole key bindings。

Linux virtual console

Linux virtual console，例如 Ctrl+Alt+F1，是最可能需要手動設定的環境； 它可能預設使用 high-bit Meta，而不是 ESC prefix。先查詢目前設定：

setmetamode

切換成 ESC prefix：

setmetamode escprefix

這個設定是每個 virtual terminal 各自獨立的；如果需要，可以在啟動腳本中對 使用的 /dev/ttyN 套用設定。

參考：setmetamode(1)。

tmux、screen 與 SSH

tmux、screen 和 SSH 通常只會轉送外層終端機收到的位元組，不會自動修正 Alt／Meta。請先確認最外層終端機能送出 ESC prefix，再檢查 tmux 或 screen 是否有自訂設定攔截 Alt 快捷鍵。

測試 Alt／Meta

執行：

cat -v

按下 Alt+V，應該看到類似：

^[v

其中 ^[ 代表 ESC。按下 Ctrl+C 結束 cat，接著可以直接在 zago 測試 M+V 或 M+W。

Clone this wiki locally