如何在Debian进行Java编译测试

在 Debian 上进行 Ja va 编译与测试

想在 Debian 系统上顺畅地编译和测试 Ja va 代码吗？其实过程并不复杂，关键在于把环境准备妥当。下面这份指南，将带你从零开始，一步步搞定从基础编译到单元测试的全流程。

一 准备环境

万事开头难，而搭建环境就是这第一步。做对了，后面事半功倍。

更新软件源并安装 JDK（推荐 OpenJDK 17 或 11）：这是所有工作的基石。打开终端，执行安装命令：sudo apt update && sudo apt install openjdk-17-jdk（或者选择 openjdk-11-jdk）。安装完成后，别忘了用 ja va -version 和 ja vac -version 验证一下，确保版本号正确显示。

可选：设置 JA VA_HOME（很多框架和工具依赖）：虽然非强制，但为后续使用各种工具（如 Ma ven、Gradle）扫清障碍，强烈建议设置。先通过 readlink -f /usr/bin/ja vac 找到 JDK 的实际安装路径，然后将其写入全局环境变量。例如，执行 echo ‘JA VA_HOME=“/usr/lib/jvm/ja va-17-openjdk-amd64”’ | sudo tee -a /etc/environment，最后用 source /etc/environment 让配置立即生效。

可选：多版本切换：如果你的系统安装了多个 Ja va 版本，管理起来也很简单。使用 sudo update-alternatives --config ja va 和 sudo update-alternatives --config ja vac 命令，系统会列出所有可用版本，交互式地让你选择当前要使用的那个。

二 命令行编译与运行

环境就绪，就可以开始最直接的编译和运行了。从简单的单文件到稍复杂的多文件项目，命令行都能搞定。

单文件：这是最经典的入门操作。编译命令是 ja vac HelloWorld.ja va，这会在当前目录生成一个 HelloWorld.class 文件。运行它时，记住命令是 ja va HelloWorld，千万不要在后面加上 .class 后缀。

指定输出目录与类路径：为了保持项目整洁，我们通常会把编译输出的 .class 文件放到单独的目录，比如 bin。这时可以这样编译：ja vac -d bin HelloWorld.ja va。运行的时候，则需要通过 -cp（classpath）参数告诉 Ja va 虚拟机去哪里找这个类：ja va -cp bin HelloWorld。

多文件一起编译：当项目有多个相互关联的 .ja va 源文件时，可以一次性编译它们：ja vac File1.ja va File2.ja va File3.ja va。编译器会自动处理它们之间的依赖关系。

小技巧：有几个命令在排查问题时非常有用。想确认 JDK 到底装在哪了？readlink -f /usr/bin/ja vac 会给你确切的路径。想查看当前目录下生成了哪些类文件？用 ls -l *.class 或者 find . -name "*.class" 都能一目了然。

三 使用构建工具进行单元测试

对于正式项目，手动管理编译和依赖会非常繁琐。这时，就该构建工具和单元测试框架登场了，它们是保障代码质量的黄金组合。

使用 Ma ven：首先安装它：sudo apt install ma ven。你可以用它快速创建一个标准项目结构：mvn archetype:generate -DgroupId=com.example -DartifactId=demo -DarchetypeArtifactId=ma ven-archetype-quickstart -DinteractiveMode=false。项目创建后，运行 mvn test 命令会自动执行所有单元测试，详细的测试报告会生成在 target/surefire-reports 目录下。

使用 Gradle：另一个流行的选择是 Gradle，安装命令为 sudo apt install gradle。在配置好的 Gradle 项目中，运行测试同样简单：gradle test。

常用测试框架：目前，JUnit 5 是 Ja va 单元测试的事实标准。在 Ma ven 项目中，你通常需要在 pom.xml 中添加类似以下的依赖（scope 为 test）：

• org.junit.jupiter:junit-jupiter-api:5.7.0
• org.junit.jupiter:junit-jupiter-engine:5.7.0

四 常见问题与排查

开发过程中难免遇到问题，这里有几个高频“坑点”和解决方案。

命令未找到：如果系统提示 ja va 或 ja vac 命令不存在，首先确认 JDK 是否真的安装了：sudo apt install openjdk-17-jdk。安装后仍不行，可以用 which ja va 和 which ja vac 检查命令路径是否在系统环境变量中。

版本不一致：有时 ja va -version 和 ja vac -version 显示的版本不同，这可能导致编译和运行环境不匹配。使用 sudo update-alternatives --config ja va（以及 config ja vac）来统一切换系统默认版本。

类找不到：运行时报 ClassNotFoundException 或 NoClassDefFoundError，多半是类路径没设对。确保使用 -cp 参数正确指定了包含 .class 文件的目录，例如 ja va -cp bin HelloWorld。另外，如果类定义了包名，那么目录结构必须与之匹配，并且运行时需要使用完整的类名（含包名）。

编码问题：源代码文件如果包含中文等非 ASCII 字符，编译时可能会遇到编码错误。解决办法是在编译时显式指定编码，如 ja vac -encoding UTF-8 HelloWorld.ja va。

权限问题：如果你自己编写了编译或运行的 Shell 脚本，直接运行可能会提示权限不足。记得先给它加上可执行权限：chmod +x build.sh。

五 一键脚本示例

对于重复的编译-运行操作，写一个简单的 Shell 脚本能极大提升效率。

保存为 build_and_run.sh：将以下内容保存到一个文件中：

#!/bin/bash
set -e
ja vac -d bin HelloWorld.ja va
ja va -cp bin HelloWorld

赋予执行权限并运行：首先，通过 chmod +x build_and_run.sh 命令让脚本变得可执行。之后，每次只需要在终端输入 ./build_and_run.sh，它就会自动完成编译和运行全过程。