VS Code 開發 Java 常用快捷鍵介紹

發表於 2026-06-23 分類於 vscodelife

VS Code 開發 Java 常用快捷鍵介紹

簡介

VS Code 搭配 Extension Pack for Java 後，已經可以完成 Java 專案開發中常見的編輯、導覽、重構、測試與除錯工作。不過，如果每個動作都依賴滑鼠點選，開發節奏很容易被打斷。熟悉幾組常用快捷鍵，可以讓你在閱讀程式碼、追蹤呼叫關係、修正錯誤與啟動 Debug 時更加順手。

這篇文章整理在 VS Code 上開發 Java 時最常用的快捷鍵，會以實際開發情境分類，方便你依照自己的使用頻率逐步記起來。

開始前：快捷鍵可能因作業系統不同

VS Code 的快捷鍵會依照作業系統略有差異。以下表格以 Windows / Linux 與 macOS 對照說明：

動作	Windows / Linux	macOS
開啟命令面板	`Ctrl + Shift + P`	`Cmd + Shift + P`
快速開啟檔案	`Ctrl + P`	`Cmd + P`
開啟鍵盤快捷鍵設定	`Ctrl + K Ctrl + S`	`Cmd + K Cmd + S`

如果某個快捷鍵在你的環境中沒有作用，可以先開啟 Keyboard Shortcuts，搜尋對應命令名稱確認目前綁定。VS Code 也支援自訂快捷鍵，因此可以依照自己的習慣調整。

基礎操作快捷鍵

命令面板

功能	Windows / Linux	macOS	使用情境
開啟命令面板	`Ctrl + Shift + P`	`Cmd + Shift + P`	搜尋並執行所有 VS Code 命令
快速開啟檔案	`Ctrl + P`	`Cmd + P`	在專案中快速切換 Java 檔案
前往指定行	`Ctrl + G`	`Ctrl + G`	依照錯誤訊息中的行號快速定位

命令面板是 VS Code 中最重要的入口之一。當你不確定某個功能在哪裡時，可以先按下 Ctrl + Shift + P，再輸入關鍵字搜尋。例如：

Java: Clean Java Language Server Workspace
Java: Configure Java Runtime
Preferences: Open Keyboard Shortcuts
Developer: Reload Window

對 Java 開發來說，命令面板特別適合處理不常使用、但偶爾會需要的 Java extension 指令。

檔案與視窗切換

功能	Windows / Linux	macOS	使用情境
切換側邊欄顯示	`Ctrl + B`	`Cmd + B`	專注閱讀程式碼或重新顯示檔案總管
開啟檔案總管	`Ctrl + Shift + E`	`Cmd + Shift + E`	瀏覽專案目錄
開啟搜尋	`Ctrl + Shift + F`	`Cmd + Shift + F`	全專案搜尋 class、method 或字串
開啟原始碼控制	`Ctrl + Shift + G`	`Ctrl + Shift + G`	查看 Git 修改內容
開啟執行與除錯	`Ctrl + Shift + D`	`Cmd + Shift + D`	切換到 Debug 視圖
開啟擴充功能	`Ctrl + Shift + X`	`Cmd + Shift + X`	安裝或管理 Java 相關 extension

Java 專案通常檔案數量較多，尤其是 Spring Boot 或大型模組化專案。善用 Ctrl + P 與 Ctrl + Shift + F，可以大幅減少在檔案樹中層層展開資料夾的時間。

Java 程式碼導覽快捷鍵

前往定義與參考

功能	Windows / Linux	macOS	使用情境
前往定義	`F12`	`F12`	跳到 class、method、field 的定義位置
預覽定義	`Alt + F12`	`Option + F12`	在目前檔案中以小視窗查看定義
尋找所有參考	`Shift + F12`	`Shift + F12`	查看某個 method 或 class 被哪些地方使用
回到上一個位置	`Alt + Left`	`Ctrl + -`	從定義位置回到原本閱讀的位置
前往下一個位置	`Alt + Right`	`Ctrl + Shift + -`	在導覽歷史中往前移動

閱讀 Java 程式碼時，最常見的動作就是追蹤 class 與 method 的來源。F12 適合直接跳轉，Alt + F12 則適合快速確認實作內容，但不想離開目前檔案的情境。

如果你正在分析一個 service method 會被哪些 controller 或其他 service 呼叫，Shift + F12 會非常實用。它可以快速列出所有參考位置，讓你評估修改這段程式碼可能影響的範圍。

符號搜尋

功能	Windows / Linux	macOS	使用情境
搜尋目前檔案中的符號	`Ctrl + Shift + O`	`Cmd + Shift + O`	在同一個 Java 檔案中快速跳到 method 或 field
搜尋工作區符號	`Ctrl + T`	`Cmd + T`	依照 class 或 method 名稱在整個專案中搜尋
顯示 Hover 資訊	`Ctrl + K Ctrl + I`	`Cmd + K Cmd + I`	查看型別、文件或方法簽章

當一個 Java 類別很長時，Ctrl + Shift + O 可以讓你直接輸入 method 名稱並跳轉。若你只記得類別名稱的一部分，則可以使用 Ctrl + T 在整個工作區搜尋符號。

Java 編輯與重構快捷鍵

智慧提示與快速修正

功能	Windows / Linux	macOS	使用情境
觸發建議	`Ctrl + Space`	`Ctrl + Space`	手動叫出 IntelliSense 建議
快速修正	`Ctrl + .`	`Cmd + .`	自動補 import、建立 method、修正型別錯誤
重新命名符號	`F2`	`F2`	安全地重新命名 class、method、field 或變數
整理 imports	`Shift + Alt + O`	`Shift + Option + O`	移除未使用 import，並整理 import 順序

Java 開發中很常遇到 import 尚未加入、型別名稱拼錯、method 尚未建立等情況。此時可以把游標放在錯誤位置，按下 Ctrl + . 查看 VS Code 提供的快速修正建議。

F2 是重構時很重要的快捷鍵。它會透過語言服務理解 Java 符號，而不是單純做文字取代，因此比手動搜尋取代更安全。例如重新命名 method 時，相關呼叫點也會一起更新。

格式化與註解

功能	Windows / Linux	macOS	使用情境
格式化整份文件	`Shift + Alt + F`	`Shift + Option + F`	依照 formatter 規則整理 Java 檔案
格式化選取範圍	`Ctrl + K Ctrl + F`	`Cmd + K Cmd + F`	只格式化選取的程式碼片段
切換單行註解	`Ctrl + /`	`Cmd + /`	快速註解或取消註解一行程式碼
切換區塊註解	`Shift + Alt + A`	`Shift + Option + A`	註解多行程式碼區塊

若團隊有統一的 Java formatter 設定，建議養成修改完檔案後執行格式化的習慣。這可以減少不必要的排版差異，讓 code review 更專注在實際邏輯變更。

多游標與行操作

功能	Windows / Linux	macOS	使用情境
選取下一個相同文字	`Ctrl + D`	`Cmd + D`	快速修改多個相同變數名稱或字串
加入游標	`Alt + Click`	`Option + Click`	在多個位置同時編輯
向上或向下移動整行	`Alt + Up / Down`	`Option + Up / Down`	調整欄位、import 或邏輯順序
向上或向下複製整行	`Shift + Alt + Up / Down`	`Shift + Option + Up / Down`	快速複製類似程式碼
刪除整行	`Ctrl + Shift + K`	`Cmd + Shift + K`	移除目前所在行

多游標功能適合處理規律性高的編輯，例如同時修改多個 enum value、測試資料或建構子參數。不過，如果修改的是 Java 符號名稱，仍建議優先使用 F2，避免只改到部分文字而漏掉真正的引用位置。

Java 除錯快捷鍵

啟動與控制 Debug

功能	Windows / Linux	macOS	使用情境
開始除錯或繼續執行	`F5`	`F5`	啟動 Debug，或在中斷點後繼續執行
不除錯直接執行	`Ctrl + F5`	`Ctrl + F5`	直接執行 Java 程式
停止除錯	`Shift + F5`	`Shift + F5`	結束目前 Debug session
重新啟動除錯	`Ctrl + Shift + F5`	`Cmd + Shift + F5`	重新執行目前 Debug session
切換中斷點	`F9`	`F9`	在目前行加入或移除 breakpoint

在 Java 開發中，Debug 通常會比單純印出 log 更有效率。當你要確認某個條件分支是否進入、變數值是否如預期，或 API 回傳資料是否正確時，可以先在關鍵行按下 F9 加入中斷點，再按 F5 啟動除錯。

單步執行

功能	Windows / Linux	macOS	使用情境
Step Over	`F10`	`F10`	執行目前行，但不進入 method 內部
Step Into	`F11`	`F11`	進入目前呼叫的 method
Step Out	`Shift + F11`	`Shift + F11`	離開目前 method，回到呼叫端

如果你只想確認目前流程，不需要深入每個 method，可以使用 F10。如果懷疑問題出在某個 method 內部，則使用 F11 進入檢查。當已經看完目前 method 的邏輯，可以按 Shift + F11 回到上一層。

測試與問題排查快捷鍵

測試相關操作

VS Code 的 Java 測試功能通常會搭配 Test Runner for Java。測試方法或測試類別上方會出現 CodeLens，可以直接點選 Run Test 或 Debug Test。

如果想透過鍵盤操作，可以使用命令面板搜尋測試相關命令，例如：

Test: Run All Tests
Test: Debug All Tests
Java: Go to Test

這些命令不一定都有預設快捷鍵。若你經常執行特定測試命令，可以在 Keyboard Shortcuts 中搜尋命令名稱，手動綁定自己習慣的按鍵組合。

錯誤與診斷資訊

功能	Windows / Linux	macOS	使用情境
開啟 Problems 視圖	`Ctrl + Shift + M`	`Cmd + Shift + M`	查看編譯錯誤、警告與語法問題
前往下一個錯誤或警告	`F8`	`F8`	在問題清單中往下一個項目移動
前往上一個錯誤或警告	`Shift + F8`	`Shift + F8`	在問題清單中往上一個項目移動

Java 專案若有語法錯誤、缺少 import、型別不相容或建置設定問題，通常可以先從 Problems 視圖找到線索。搭配 F8 與 Shift + F8，可以不用離開鍵盤就逐一檢查問題位置。

終端機與工作區操作

功能	Windows / Linux	macOS	使用情境
開啟或關閉終端機	Ctrl + `	Ctrl + `	執行 Maven、Gradle 或其他 CLI 指令
切換面板顯示	`Ctrl + J`	`Cmd + J`	顯示或收合下方面板
建立新終端機	Ctrl + Shift + `	Ctrl + Shift + `	開新終端機執行不同任務

即使 VS Code 已經提供許多 Java 視覺化操作，實務上仍常需要使用終端機執行建置或測試指令，例如：

mvn test

1	gradle test

熟悉終端機快捷鍵後，可以在編輯器與 CLI 之間快速切換，對日常開發很有幫助。

建議優先記住的快捷鍵

如果一次記太多快捷鍵，反而容易用不上。建議可以先從以下幾組開始：

優先順序	快捷鍵	用途
1	`Ctrl + P`	快速開啟檔案
2	`Ctrl + Shift + P`	開啟命令面板
3	`F12`	前往定義
4	`Shift + F12`	尋找所有參考
5	`Ctrl + .`	快速修正
6	`F2`	重新命名符號
7	`Shift + Alt + F`	格式化文件
8	`F5` / `F9`	啟動 Debug 與設定中斷點

這幾個快捷鍵涵蓋了 Java 開發中最常見的流程：找檔案、看程式碼、修錯誤、重構與除錯。先把它們用熟，再逐步加入多游標、符號搜尋與測試相關操作，會比較容易養成習慣。

自訂快捷鍵

每個人的開發習慣不同，有些快捷鍵也可能被作業系統、輸入法或其他應用程式攔截。你可以透過以下方式調整：

按下 Ctrl + K Ctrl + S 開啟 Keyboard Shortcuts。
搜尋想調整的命令名稱，例如 Organize Imports、Run All Tests 或 Go to Definition。
點選鉛筆圖示，輸入新的按鍵組合。
若出現衝突提示，再依照實際使用頻率決定是否覆蓋。

對 Java 開發者來說，特別推薦確認 Quick Fix、Organize Imports、Format Document、Run Test 與 Debug Test 這幾類命令是否符合自己的習慣。這些動作通常每天都會使用，調整到順手後能明顯提升開發效率。

結語

VS Code 的 Java 開發體驗很大一部分來自語言服務與快捷鍵的配合。當你熟悉 F12、Shift + F12、Ctrl + .、F2、F5 這些操作後，閱讀與修改 Java 程式碼會變得更流暢，也能更快掌握專案中的呼叫關係與錯誤來源。

快捷鍵不需要一次全部背起來。最好的方式是在日常開發中挑出最常重複的動作，先記住對應的幾組按鍵，再慢慢擴充自己的快捷鍵清單。當手指開始自然完成這些操作時，VS Code 就會真正變成更貼近 Java 開發節奏的工具。