在 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 不在当前目录/类路径;核对类名并确认在正确目录执行。