在 Ubuntu 上编译 Java 程序时报错，很多时候并不是代码本身有多复杂，而是 JDK、环境变量、类路径和文件路径这些基础项没有对齐。与其反复重装，不如按一条固定排查链路处理：先确认编译器可用，再检查配置是否指向正确版本，最后根据报错关键词定位到代码、依赖或运行入口。
下面这篇指南把常见问题拆成几个明确步骤，保留了命令、版本和典型错误信息。你可以从头顺着检查，也可以直接跳到和自己报错最接近的一节，对照判断该修哪一层。
先确认 JDK 是否已正确安装
在 Ubuntu 里，能不能编译 Java，第一步不是看 IDE，而是看系统里有没有可用的 JDK。先执行下面两个命令：
java -version
javac -version如果命令不存在，或者 javac 无法使用，说明编译环境没有装完整。以 OpenJDK 17 为例，可以直接安装：
sudo apt update
sudo apt install openjdk-17-jdk如果系统里已经安装了多个 JDK，但当前默认版本不对，可以用 update-alternatives 切换：
sudo update-alternatives --config java
sudo update-alternatives --config javac这一步的目标很简单：确保 java 和 javac 都能正常执行，而且指向的是你打算使用的 JDK 版本。
环境变量为什么会影响编译
JDK 已经安装好，但编译仍然异常时，下一步要看环境变量是否配置正确。常见做法是检查 JAVA_HOME 和 PATH。
编辑 ~/.bashrc 或 ~/.zshrc：
nano ~/.bashrc加入以下内容，这里仍以 OpenJDK 17 为例：
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64
export PATH=$JAVA_HOME/bin:$PATH保存后执行：
source ~/.bashrc然后用下面两个命令确认结果：
echo $JAVA_HOME
echo $PATH如果 JAVA_HOME 指向了错误目录，或者 PATH 里排在前面的其实是别的 Java 版本，编译和运行就可能出现版本不一致、工具不可用等问题。
代码层面的基础错误怎么查
如果环境本身没问题，编译器给出的报错通常就开始指向代码。Java 的语法报错一般比较直接，重点先看行号和错误类型。
类名与文件名必须一致
如果代码里写的是 public class HelloWorld，文件名就必须是 HelloWorld.java，而且大小写也要完全一致。
语句末尾不能漏分号
例如下面这类语句必须以分号结束：
System.out.println("Hello");少一个分号，编译器通常会直接提示语法错误。
变量和方法要先定义再使用
例如：
System.out.println(b);如果 b 从未声明，就会出现“找不到符号”之类的报错。这类问题通常不需要改环境，回到对应代码行检查即可。
类路径和文件路径是两类不同问题
很多初学者会把类路径问题和文件路径问题混在一起，但它们对应的是两层完全不同的错误来源。
依赖外部库时要显式指定 Classpath
如果程序依赖外部 .jar 文件，编译时需要通过 -cp 或 -classpath 指定：
javac -cp ".:/path/to/library.jar" HelloWorld.java.表示当前目录；- Linux 和 macOS 下多个路径用冒号分隔；
- Windows 下多个路径用分号分隔。
如果这里漏掉依赖路径，常见结果就是编译时报找不到某个类。
源文件路径不对时，编译器甚至找不到文件
先确认 Java 文件是否真的在当前目录：
ls如果不在当前目录，可以切换目录后再编译，或者直接使用绝对路径：
javac /home/user/code/HelloWorld.java如果使用相对路径，例如 ./subdir/HelloWorld.java，也要确认对应目录真实存在。
旧的 .class 文件为什么也会制造麻烦
有些报错并不是当前源码直接造成的，而是之前留下的 .class 文件和新代码不匹配。尤其是改过类名、包名或依赖版本之后，残留文件很容易干扰结果。
可以先删除当前目录下已有的 .class 文件，再重新编译：
rm *.class
# 删除当前目录下所有.class文件
javac HelloWorld.java
# 重新编译如果清理后问题消失，说明之前的编译产物已经和当前源码状态不一致了。
项目一复杂，手动编译就该交给构建工具
当项目只有一个或几个源文件时，手动执行 javac 还比较直观；但如果依赖多、模块多，继续手工维护类路径和编译顺序，出错概率会明显上升。
这时更合适的做法是改用 Maven 或 Gradle。以 Maven 为例：
mvn archetype:generate -DgroupId=com.example -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
mvn compile
mvn package构建工具的价值，不只是“省事”，更重要的是把依赖管理、编译流程和打包方式固定下来，减少环境差异导致的问题。
看懂详细日志，才能更快定位根因
如果基础错误信息还不够明确，可以给 javac 加上 -verbose：
javac -verbose HelloWorld.java这样会输出更详细的编译日志，适合排查“到底卡在哪一步”。尤其当日志里已经明确出现“找不到符号”或“类版本不兼容”时，问题范围其实已经被缩小得很明显了。
常见特定错误可以这样理解
- Error: Could not find or load main class：常见原因包括类路径里没包含当前目录、类名拼写错误，或者主类没有定义
public static void main(String[] args)方法。 - UnsupportedClassVersionError：通常表示编译版本高于运行版本，比如用 JDK 17 编译，却拿 JDK 8 去运行。可以统一 JDK 版本，或者在编译时指定目标版本，例如
javac -target 1.8 HelloWorld.java。 - NoClassDefFoundError：更常见于运行阶段，说明依赖类没有被正确找到，重点检查依赖是否完整，以及类路径设置是否正确。
排查顺序比反复重装更重要
Ubuntu 下的 Java 编译报错，大多数都能归到四类：JDK 未正确安装、环境变量配置错误、类路径或文件路径不对、代码本身存在语法或引用问题。按“工具链、配置、源码、依赖、日志”这个顺序排查，通常比一上来重装环境更快。
如果你已经执行过上面的命令，但问题还没有收敛，下一步最有价值的信息就是完整报错文本和你当前使用的 JDK 版本。很多看起来相似的错误，真正的根因其实只差一条日志。
