Java 開發環境搭建與 Eclipse 基礎配置全攻略：從 JDK 安裝到編碼規範

一、JDK 安裝與環境變量配置（Windows 為例）

1. 下載安裝：Oracle 官網 / Adoptium 下載 JDK 17/21 LTS 版，建議安裝路徑無中文、無空格（如 D:\Java\jdk-21）。
2. 配置系統變量：
   • JAVA_HOME = D:\Java\jdk-21
   • Path 追加 %JAVA_HOME%\bin
   • CLASSPATH = .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar（現代構建工具 Maven/Gradle 不依賴此變量，可省略）
3. 驗證：CMD 執行 java -version、javac -version 輸出版本信息即成功。

二、Eclipse IDE 核心配置

1. 工作空間編碼統一

Window → Preferences → General → Workspace：Text file encoding = UTF-8，New text file line delimiter = Unix。防止中文亂碼、換行符差異導致 Git diff 噪音。

2. 代碼格式化與導入組織

• Java → Code Style → Formatter：導入團隊統一 formatter.xml（Google Java Style / Alibaba Java Style）。
• Java → Editor → Save Actions：勾選 Format source code、Organize imports、Additional actions（如移除未使用變量、添加 @Override 等），保存即自動美化。

3. 智能提示增強

Java → Editor → Content Assist：Auto activation triggers for Java 填入 ._abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ，輸入任意字符即觸發提示，無需按 Alt+/。

4. 顯示行號與空白字符

General → Editors → Text Editors：勾選 Show line numbers、Show whitespace characters。

5. 字體與主題

General → Appearance → Colors and Fonts → Basic → Text Font：推薦 JetBrains Mono、Fira Code（支持連字符）、Consolas，大小 14-16。Theme 選 Dark 護眼。

6. 文件關聯修正

General → Editors → File Associations：*.jsp 關聯 JSP Editor（非 Visual JSP Designer），避免「Unhandled event loop exception」崩潰。

7. 專案命名規範

修改專案名需同步修改 .project 文件中 <name> 標籤，單純重命名文件夾會導致 Eclipse 識別異常。

三、進階效率插件推薦

• Eclipse Code Recommenders：智能代碼補全排序。
• AnyEdit Tools：保存時自動去除尾隨空格、轉換換行符。
• Git Integration (EGit)：內置 Git 可視化操作。
• Maven/Gradle Integration：構建工具深度集成。
• Checkstyle / PMD / SpotBugs：靜態代碼分析門禁。

四、常見問題排查