java编译失败首要排查文件名与public类名是否严格一致（含大小写），其次检查分号、括号、引号缺失，再确认jdk版本匹配、符号声明及ide编译器异常。
Java项目编译失败时，控制台报出一长串红色错误信息，光看类名和行号根本无从下手，更别说快速定位是环境配置问题、语法硬伤还是版本错配。这类报错必须在编译阶段就拦截解决，否则连运行入口都进不去。
文件名与public类名不一致
第一步：打开报错提示中提到的.java文件，确认文件名（含扩展名）是否与文件内声明的public类名完全相同。
第二步：若文件名为HelloWorld.java，但类声明为public class helloWorld，则必须将类名改为HelloWorld——大小写必须严格一致。
第三步：如果不想改类名，可直接删掉public修饰符，改为class helloWorld；但【这种改法仅限学习调试，正式项目严禁使用】，否则其他类无法访问该类，模块化结构会彻底失效。
缺少分号、括号或引号
方法一：逐行检查报错行及上一行。Java每条语句必须以分号结尾，漏写会导致后续所有语法解析错位，IDE常把真实错误位置标偏。
方法二：用IDEA快捷键Ctrl+Alt+L格式化代码，自动对齐大括号并高亮未闭合结构；若某处缩进突然塌陷，大概率是少了一个}。
方法三：字符串引号不闭合时，整段代码会变成注释色或报unclosed string literal；直接在报错行末尾补一个"，再检查前面是否多打了一个"导致提前闭合。
JDK版本不匹配引发UnsupportedClassVersionError
这个错误本质是“用新刀切旧木”：JDK 17编译出的class文件（版本号61.0），被JRE 8（只认到52.0）强行加载。
进入File → Project Structure → Project，确认Project SDK和Language level是否均为目标版本（如JDK 17→选17）。
打开pom.xml，检查maven-compiler-plugin是否显式锁定了source/target：
若存在<source>21</source><target>21</target>，而本地SDK却是JDK 17，必须同步改成17。
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
【关键动作】右键项目→Maven→Reload，强制刷新编译配置，否则修改无效。
找不到符号：变量/方法/类未声明
报错形如cannot find symbol，先看符号类型：
如果是变量名报错，立即检查作用域——for循环内定义的int i = 0，不能在循环外System.out.println(i)。
如果是方法名报错，确认拼写是否正确：String.valueOf()不是String.valurOf()，也不是string.valueOf()（首字母必须大写）。
如果是类名报错（如ArrayList标红），检查是否遗漏import java.util.ArrayList;；Spring类报错则多半是Maven依赖未下载完成，点Maven面板的刷新按钮。
内部编译器错误：internal java compiler error
这不是你代码的问题，是IDEA的javac进程崩了。优先执行以下三项：
① 清除编译缓存：菜单栏File → Invalidate Caches and Restart → Invalidate and Restart。
② 关闭编译器内置构建：进入Settings → Build → Compiler → Java Compiler，取消勾选Use compiler from IDE，改用外部JDK自带的javac。
③ 检查项目根目录是否存在.idea/misc.xml，用文本编辑器打开，删除其中包含<component name="CompilerConfiguration"></component>的整段内容，保存后重启IDEA。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
