Sublime Text 3 配置 Java 開發環境完整教程：從安裝到高效編碼

Sublime Text 以極速啟動、極簡介面、強大擴充生態深受開發者喜愛。本教程詳細說明如何將 Sublime Text 3 配置為輕量級 Java IDE，涵蓋 JDK 環境變數、建構系統、代碼補全、除錯整合等核心環節。

前置準備：JDK 環境變數配置

Windows

1. 右鍵「此電腦」→「屬性」→「進階系統設定」→「環境變數」
2. 系統變數編輯 Path，新增 JDK bin 目錄（如 C:\Program Files\Java\jdk-17\bin）
3. 新增 JAVA_HOME 指向 JDK 根目錄
4. 驗證：cmd 執行 java -version、javac -version

Linux/macOS

# ~/.bashrc 或 ~/.zshrc
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
export PATH=$JAVA_HOME/bin:$PATH

# 立即生效
source ~/.bashrc

建構系統配置：一鍵編譯運行

Windows：建立 runJava.bat

@ECHO OFF
cd %~dp1
ECHO Compiling %~nx1.......
IF EXIST %~n1.class (DEL %~n1.class)
javac %~nx1
IF EXIST %~n1.class (
    ECHO -----------OUTPUT-----------
    java %~n1
)

放置於 %JAVA_HOME%\bin 目錄。

Linux/macOS：建立 runJava.sh

#!/bin/bash
cd "$(dirname "$1")"
FILENAME=$(basename "$1" .java)
echo "Compiling $FILENAME.java..."
javac "$FILENAME.java"
if [ -f "$FILENAME.class" ]; then
    echo "-----------OUTPUT-----------"
    java "$FILENAME"
else
    echo "Compilation failed."
fi

chmod +x runJava.sh
sudo mv runJava.sh $JAVA_HOME/bin/

Sublime Build System 修改

1. 選單 Preferences → Browse Packages...
2. 進入 Java 資料夾
3. 編輯 JavaC.sublime-build

Windows 版

{
    "cmd": ["runJava.bat", "$file"],
    "file_regex": "^(...*?):([0-9]*):?([0-9]*)",
    "selector": "source.java",
    "encoding": "utf-8"
}

Linux/macOS 版

{
    "cmd": ["runJava.sh", "$file_base_name"],
    "file_regex": "^(...*?):([0-9]*):?([0-9]*)",
    "selector": "source.java",
    "encoding": "utf-8"
}

必裝增強套件

LSP-java 關鍵配置

// Preferences → Package Settings → LSP → Settings
{
    "clients": {
        "lsp-java": {
            "enabled": true,
            "command": ["jdtls"], // 需預先安裝 jdtls
            "scopes": ["source.java"],
            "syntaxes": ["Packages/Java/Java.sublime-syntax"],
            "initializationOptions": {
                "extendedClientCapabilities": {
                    "classFileContentsSupport": true
                }
            }
        }
    }
}

jdtls 安裝：下載 Eclipse JDT Language Server，解壓並加入 PATH。

專案配置：.sublime-project

{
    "folders": [{"path": "."}],
    "settings": {
        "java_classpath": "target/classes:lib/*",
        "java_output_path": "target/classes"
    },
    "build_systems": [
        {
            "name": "Run Java",
            "cmd": ["runJava.bat", "$file"],
            "file_regex": "^(...*?):([0-9]*):?([0-9]*)"
        }
    ]
}

除錯整合：Debug Adapter Protocol

1. 安裝 LSP、Debugger 套件
2. 配置 java-debug adapter
3. 在代碼行號左側點擊設置斷點
4. Ctrl+Shift+P → Debug: Start Debugging

常見問題排查

進階技巧

• 多檔案編譯：Build System 改為 javac *.java 或使用 Maven/Gradle 外部建構
• 代碼片段：Tools → Developer → New Snippet 建立常用模板
• 正則替換：Ctrl+H 開啟強大的正則表達式搜尋替換
• 多游標編輯：Ctrl+Click / Ctrl+D 選取下一個相同詞

Sublime Text + LSP-java 可提供接近 IDE 的開發體驗，同時保持極速啟動與低資源佔用。適合中小型專案、單檔案原型驗證、配置文件編輯等場景。大型企業級專案仍建議使用 IntelliJ IDEA 或 Eclipse 獲得完整重構、測試、框架整合支援。