隨記

VS Code Java Settings 說明

概述

此 .vscode/settings.json 文件用於配置 Visual Studio Code 中 Java 開發環境的行為。專案使用 Java 8 進行編譯和建置，並配置多個 JDK 版本以支援不同需求。

設定項目詳解

Gradle 相關設定

  • "gradle.java.home": "D:\\java\\jdk1.8"
  • 指定 Gradle 建置工具使用的 JDK 路徑

  • 確保專案使用 Java 8 進行編譯和建置

  • "gradle.debug": true

  • 啟用 Gradle 調試模式

  • 有助於排查建置問題

  • "gradle.disableConfirmations": true

  • 禁用 Gradle 確認對話框
  • 自動執行建置任務而不需手動確認

JDK 運行時配置

  • "java.configuration.runtimes"
  • 定義 VS Code 可用的 JDK 版本列表
  • 每個運行時包含名稱、路徑和是否為預設
  • 支援 Java 8、11、17、21 等版本
  • "default": true 表示 JavaSE-1.8 為預設運行時

建置配置

  • "java.configuration.updateBuildConfiguration": "automatic"
  • 自動更新專案的建置配置
  • 當專案結構改變時自動調整設定

伺服器啟動模式

  • "java.server.launchMode": "Standard"
  • 設定 Language Server 的啟動模式
  • "Standard" 表示標準啟動模式

Gradle 匯入設定

  • "java.import.gradle.enabled": true"
  • 啟用 Gradle 專案的自動匯入

  • VS Code 會自動解析 Gradle 專案結構

  • "java.import.gradle.wrapper.enabled": true

  • 啟用 Gradle Wrapper 支援

  • 使用專案中的 gradlew 腳本而非系統 Gradle

  • "java.import.gradle.java.home": "D:\\java\\jdk1.8"

  • 指定 Gradle 匯入過程使用的 JDK
  • 確保與建置 JDK 一致

終端配置

  • "terminal.integrated.env.windows": {"JAVA_HOME": "D:\\java\\jdk21"}
  • 在集成終端中設置 JAVA_HOME 環境變數為 JDK 21
  • 確保終端使用 JDK 21

依賴包顯示設定

  • "java.dependency.packagePresentation": "hierarchical"
  • 設置依賴包的顯示方式為層次結構
  • 有助於更好地組織和查看專案依賴

解決的問題

此配置解決了以下常見問題：

  1. 專案相容性：專案繼續使用 Java 8 編譯，保持與現有依賴的相容性
  2. 建置一致性：確保 Gradle 建置始終使用正確的 JDK 版本
  3. 多版本支援：配置多個 JDK 版本以支援不同開發需求

使用建議

  • 重新載入 VS Code 視窗以使設定生效
  • 如果遇到問題，可以通過 Java: Clean Java Language Server Workspace 命令清理快取
  • 確保所有 JDK 路徑正確指向有效的安裝目錄

修改日期

2025-12-03