繁體中文
如何在 Mac 上的 VS Code 使用滑鼠按鈕
這款 App 完全免費。不需要建立帳號。沒有訂閱，沒有麻煩的下載，也沒有任何鎖住的功能。針對 Apple 晶片最佳化。
VS Code 本來就把側邊按鈕當作上一頁和下一頁，而在 Mac 上做到這一點的內建方法是一項設定，不是對應工具。對應工具能多做的工作是執行、建置、停止和偵錯器的步驟，也就是放在按鈕上的按鍵。InputConfig（我做的免費 Mac App）會掃描任何滑鼠按鈕，並送出一個按鍵或一整組快速鍵，還能跟著最前方的 VS Code。這個 App 完全免費，也不用建立帳號。
這些按鍵來自 Microsoft 的 macOS 鍵盤快速鍵表、偵錯頁面和工作頁面，我在 2026 年 10 月 21 日讀過。下面的 Xcode 區段使用的是 Apple 自己的清單。
InputConfig 1.7 版預計於 2026 年 10 月推出，屆時 App 將完整支援繁體中文。
步驟
- 在 VS Code 的設定裡搜尋 mouse back forward，確認 Enables the use of mouse buttons four and five 已開啟。
- 安裝 InputConfig，並在「系統設定」的「隱私權與安全性」、「輔助使用」中允許輔助使用權限。
- 新增一列，把輸入設為滑鼠，按下掃描(Scan)並點一個拇指按鈕，然後選擇鍵盤按鍵(Keyboard Key)和執行或建置的快速鍵。
- 請讓 VS Code 遠離任何送出 Command 左方括號或 Command 右方括號的預設集，它們會縮排和取消縮排程式行。
- 在「這些 App 在最前方時啟用」下列出 VS Code，開啟「最前方 App 改變時切換預設集」，然後按「啟用」。
VS Code 和 macOS 給滑鼠什麼
VS Code 有一項設定 workbench.editor.mouseBackForwardToNavigate，它的原始碼把它描述為讓滑鼠按鈕四和五執行「上一個位置」(Go Back)和「下一個位置」(Go Forward)指令，預設是開啟的。這是我在 2026 年 10 月 21 日讀到的 VS Code 在 GitHub 上的原始碼。所以側邊按鈕回報為按鈕 4 和按鈕 5 的滑鼠，應該不需要任何幫助就能導覽。
根據 Microsoft 的表，鍵盤上的對應是 Control 減號為上一個位置，Control Shift 減號為下一個位置。如果你的側邊按鈕在 VS Code 裡已經能導覽，就別動它們，把對應工具用在沒有反應的按鈕上。
查出每個按鈕送出什麼
滑鼠按鈕會以左鍵點按、右鍵點按、中鍵點按或按鈕 4 以上的形式送到 Mac。按下掃描，再點按那個按鈕。如果掃描說出的是按鍵而不是滑鼠按鈕，表示滑鼠送出的是按鍵，解決辦法在 Mac 上的 F13 到 F19。
| 按鈕 | 通常的回報方式 | 適合的 VS Code 工作 |
|---|---|---|
| 左鍵點按與右鍵點按 | 左鍵點按與右鍵點按 | 別動它們。它們無法被阻擋。 |
| 按下滾輪 | 中鍵點按 | 關閉編輯器，Command W，或前往定義，F12。 |
| 側邊按鈕 | 按鈕 4 和按鈕 5 | 上一頁和下一頁，VS Code 可能本來就會。 |
| 拇指按鈕格或額外按鈕 | 按鈕 6 以上 | 執行、停止、逐步執行、逐步跳入、建置。 |
| 傾斜滾輪 | 橫向捲動 | 上一個和下一個編輯器分頁。 |
| DPI 或設定檔按鈕 | 通常 Mac 讀不到任何東西 | 沒有。如果掃描聽不到按下，任何 App 都讀不到。 |
Command 方括號的陷阱
InputConfig 有一個內建預設集，它送出 Command 左方括號和 Command 右方括號，把上一頁和下一頁放在側邊按鈕上，瀏覽器和 Finder 都看得懂。在 VS Code 裡，Microsoft 的表把同樣這兩個按鍵列為縮排和取消縮排行。如果那個預設集在 VS Code 位於最前方時執行，按一下側邊按鈕就會改動你的程式碼。
- 選項一。側邊按鈕交給 VS Code 自己的設定，並把這個預設集留給其他 App。
- 選項二。做一個 VS Code 預設集，在同樣的按鈕上送出 Control 減號和 Control Shift 減號，並在「這些 App 在最前方時啟用」下列出 VS Code。
- 選項三。如果 VS Code 和預設集都起作用，請在那幾列勾選 Block the button's own action，這樣上一頁就不會發生兩次。
一次只會執行一個預設集，所以 VS Code 預設集和上一頁下一頁預設集需要各自的 App 清單。同樣的兩個按鈕，在不同的 App 裡應該送出不同的按鍵，這就是各 App 預設集的用途。
把執行、建置和偵錯器放到按鈕上
步驟 1：掃描並給它執行
- 你：新增一列，把裝置設為這部 Mac 的滑鼠或觸控式軌跡板，輸入設為滑鼠，種類設為按鈕，然後按下掃描並點一個拇指按鈕。把輸出設為鍵盤按鍵，挑選 F5。
- InputConfig：每次你按按鈕就按一次 F5。
- 確認：打開一個有啟動設定的專案並按這個按鈕。偵錯器會啟動，如果已經在執行，則會繼續。
步驟 2：加入建置和停止
- 你：在下一個按鈕上，把輸出設為鍵盤按鍵，在修飾鍵底下挑選 Shift 和 Command，再加上 B。在另一個按鈕上設 Shift 和 F5。
- InputConfig：按下 Shift Command B（執行建置工作使用的），以及 Shift F5（停止偵錯）。
- 確認：按建置，工作選擇器或預設工作就會執行。按停止，偵錯器就會結束。
| 工作 | Mac 上的 VS Code 按鍵 | 適合放在哪裡 |
|---|---|---|
| 上一個位置與下一個位置 | Control 減號與 Control Shift 減號 | 按鈕 4 和按鈕 5 |
| 開始或繼續偵錯 | F5 | 一個拇指按鈕 |
| 停止偵錯 | Shift F5 | 那個按鈕的按住動作 |
| 重新啟動偵錯 | Shift Command F5 | 第二個按住動作 |
| 執行建置工作 | Shift Command B | 一個拇指按鈕 |
| 逐步執行、跳入、跳出 | F10、F11 和 Shift F11 | 三個拇指按鈕 |
| 切換中斷點 | F9 | 一個拇指按鈕 |
| 前往定義與預覽定義 | F12 與 Option F12 | 按下滾輪與按住動作 |
| 快速開啟與命令選擇區 | Command P 與 Shift Command P | 兩個拇指按鈕 |
| 顯示整合終端機 | Control 重音符號 | 一個拇指按鈕 |
| 關閉編輯器 | Command W | 按下滾輪 |
VS Code 的偵錯頁面把 F5 列為繼續或暫停，Shift F5 為停止。在工作頁面上，執行建置工作是 Shift Command B。
巨集和多步驟工作
巨集是一個勾選了「執行一連串步驟」的列，每個步驟是一個按鍵、快速鍵或點按，各有自己的等待時間。有三個適合寫程式的：
- 儲存，然後建置。Command S，短暫等待，然後 Shift Command B。它會儲存你正在編輯的檔案並開始建置。
- 停止再重新開始。Shift F5，等待一秒，然後 F5。一個按鈕就能重跑。
- 隨手可用的終端機。Control 重音符號顯示整合終端機，然後輸入文字(Type Text)輸出可以打出你整天都在執行的指令。我會省略 Return，這樣你可以先檢查。
我自己沒有在 VS Code 裡執行過這些，停止再啟動偵錯器的巨集，值得先試跑一次。請不要在任何輸入的指令裡放 Return，這樣不小心按到也不會執行它。
按住、重複、連按兩下，以及依 App 切換
- 輕點與按住。輕點送出 F5，按住送出 Shift F5，這樣一個按鈕就能開始和停止。快速輕點送出一般輸出，按住超過你設定的時間則送出別的東西。
- 按住時重複按鍵。用於 F10 逐步執行時，按住按鈕會持續逐步執行。建置時請保持關閉。
- 阻擋按鈕本身的動作。可用於中鍵和側邊按鈕，這樣預設集執行期間，App 就看不到它們。
要讓配置留在 VS Code 裡，請打開預設集的「自動化與遊戲工具」區段，在「這些 App 在最前方時啟用」下加入 Visual Studio Code，並在「設定」、「進階」裡開啟「最前方 App 改變時切換預設集」。緊急停止是 Control Option Command 加句號。
Mac 上的 Xcode
Xcode 的概念相同，只是按鍵不同。Apple 的封存表列在 Apple 封存的 Xcode 選單指令快速鍵，我在 2026 年 10 月 21 日讀過。它描述的是較舊的 Xcode，所以請打開你版本的 Product 和 Navigate 選單，每個指令都會顯示目前的按鍵。
| 工作 | Apple 的表中的 Xcode 按鍵 | 適合放在哪裡 |
|---|---|---|
| 上一個位置與下一個位置 | Control Command 向左鍵與 Control Command 向右鍵 | 按鈕 4 和按鈕 5 |
| 執行 | Command R | 一個拇指按鈕 |
| 建置 | Command B | 一個拇指按鈕 |
| 停止 | Command 句號 | 執行按鈕的按住動作 |
| 快速開啟 | Shift Command O | 按下滾輪 |
| 清除 | Shift Command K | 建置按鈕的按住動作 |
給 Xcode 它自己的預設集，並在「這些 App 在最前方時啟用」下列出它。掃描按鈕，綁定你的 Xcode 選單裡的按鍵，Xcode 就不會看到 VS Code 的按鍵。一個按鈕輕點執行、按住停止，是驅動任何一個編輯器最簡單的辦法。
按鈕在 VS Code 裡沒有反應時
照這個階梯從最小的一步開始：
- 確認預設集已開啟。按下「啟用」，並確認預設集跟隨的 App 是 VS Code。
- 檢查輔助使用。在「系統設定」的「隱私權與安全性」、「輔助使用」中。
- 檢查有沒有重複動作。如果上一頁發生兩次，表示 VS Code 自己的設定和你的列都在起作用。請勾選 Block the button's own action。
- 檢查功能鍵。F5 和 F10 在筆電上可能需要按住 Fn 鍵。請在「系統設定」的「鍵盤」中把功能鍵設為標準功能鍵，或是從這一列送出按鍵，這樣就不依賴那項設定。
- 檢查掃描。如果按鈕掃描為按鍵，請先在廠商軟體裡把它設為 F13 到 F20。
- 結束廠商的軟體。Logi Options+ 和類似的 App 可能會接管按鈕。
它做不到的事
- 讀取你的程式碼。InputConfig 送出按鍵、點按和捲動。它無法知道你在哪個檔案或偵錯器的哪種狀態。
- 分辨兩部滑鼠。每一部連接的滑鼠都算同一個裝置。
- 更改指標速度。請用 Mac 的設定、廠商的 App，或 LinearMouse、Mac Mouse Fix 或 SteerMouse。
- 只在一個專案裡執行。預設集跟隨最前方的 App，而不是資料夾或工作區。
簡短版本
- 先檢查設定。VS Code 自己就能用按鈕 4 和按鈕 5 導覽。
- 避開方括號鍵。Command 左右方括號在 VS Code 裡會縮排程式行。
- 跟著 App 走。VS Code 和 Xcode 各有自己的預設集。
在一個拇指按鈕上輕點執行、按住停止，是我會最先試的設定。
常見問題
我可以在 Mac 上的 VS Code 使用滑鼠的上一頁和下一頁按鈕嗎？
可以。VS Code 有一項設定，讓滑鼠按鈕四和五執行上一個位置和下一個位置，它的原始碼列為預設開啟。鍵盤上的按鍵是 Control 減號和 Control Shift 減號。
為什麼我的滑鼠上一頁按鈕會在 VS Code 裡縮排程式行？
有個預設集正在送出 Command 左方括號或 Command 右方括號，VS Code 用它們來縮排和取消縮排。請改用在同樣按鈕上送出 Control 減號的 VS Code 預設集。
Mac 上 VS Code 執行和建置的快速鍵是什麼？
F5 開始或繼續偵錯，Shift F5 停止，Shift Command B 執行建置工作。
我要如何用滑鼠按鈕在 VS Code 執行程式碼？
在 InputConfig 掃描這個按鈕，把輸出設為鍵盤按鍵，並挑選 F5。再加一個送出 Shift F5 的按住動作，這樣同一個按鈕就能停止它。
Mac 上 Xcode 返回上一個位置的快速鍵是什麼？
在 Apple 的表中，Control Command 向左鍵是返回，Control Command 向右鍵是前進。請查看你自己的 Xcode 選單，因為那張表是較舊版本的。
更多中文頁面
詳細指南（英文）
作者說明。Ryleigh Newman 開發了 InputConfig，因為雙手活動不便，每天都用手把操作自己的 Mac。本頁譯自英文。Mac 的語言設為繁體中文時，App 的主要按鈕和選單會顯示為中文，本頁使用這些名稱，並在括號中附上英文名稱。App 的其他部分和網站的其他頁面都是英文。
本頁的其他語言版本： English, العربية, Čeština, Dansk, Deutsch, Español, Suomi, Français, עברית, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文
免費。macOS 14 或以上版本。不需要帳號，資料不會離開你的 Mac。 原始碼在 GitHub 上.