在 Ubuntu 上编译 Java 所需工具与安装要点
一、必备工具清单
- JDK（Java Development Kit）：提供编译器 javac 与运行时 java，是编译 Java 程序的核心。Ubuntu 推荐安装 OpenJDK（如：openjdk-11-jdk、openjdk-17-jdk）。
- 构建工具（按项目选用其一）：
- Apache Maven（项目根目录含 pom.xml）
- Gradle（项目根目录含 build.gradle）
- 传统项目可选 Apache Ant（项目根目录含 build.xml）
- 版本控制（可选但强烈建议）：Git，用于拉取源码与协作。
- IDE（可选）：IntelliJ IDEA、Eclipse、VS Code（配合 Java 扩展）提升编码与调试效率。
- 数据库/容器（按项目选用）：如 MySQL/MariaDB、Apache Tomcat 等，用于联调和部署。
二、安装与验证步骤
- 1）安装 JDK（以 OpenJDK 11 为例）：
- 更新索引并安装：
sudo apt update && sudo apt install openjdk-11-jdk
- 验证：
java -version、javac -version 均应返回版本信息
- 2）安装构建工具（按需其一）：
- Maven：
sudo apt install maven；验证：mvn -v
- Gradle：可用 SDKMAN 安装（推荐）或
sudo apt install gradle；验证：gradle -v
- Ant：
sudo apt install ant
- 3）安装 Git（可选）：
sudo apt install git
- 4）多版本共存与切换：使用
sudo update-alternatives --config java 与 --config javac 选择默认版本
三、环境变量与多版本管理
- 设置 JAVA_HOME（示例为 OpenJDK 11）：
- 写入配置：
echo "export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64" >> ~/.bashrc
- 更新 PATH：
echo "export PATH=\$PATH:\$JAVA_HOME/bin" >> ~/.bashrc
- 使生效：
source ~/.bashrc；验证：echo $JAVA_HOME
- 系统级配置（可选）：编辑 /etc/environment 添加
JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"，然后重新加载环境。
四、按项目类型的快速命令示例
- 1）命令行手动编译（单文件或少量源文件）：
- 编译：
javac HelloWorld.java
- 运行：
java HelloWorld（注意：不要带 .class 后缀）
- 2）Maven 项目：
- 编译：
mvn compile；打包：mvn package（产物在 target/ 目录）
- 3）Gradle 项目：
- 构建：
gradle build（产物在 build/libs/ 目录）
五、常见问题与排查
- 报错 “javac/java: command not found”：未装 JDK 或 PATH 未包含 $JAVA_HOME/bin；重新安装 JDK 并检查 PATH，或执行
source ~/.bashrc 使配置生效。
- 报错 “error: cannot find symbol” / “syntax error”：源码存在语法或引用错误；按报错行修正，例如确保公共类名与文件名一致。
- 报错 “could not find or load main class”：运行类名大小写不一致，或 .class 不在当前目录/类路径；核对类名并确认在正确目录执行。