准备工作与目标输出目录
环境与工具
在开始将 Java 源码编译为 JAR 之前，必须确认 Java 开发工具包（JDK）已正确安装。检查 JAVA_HOME 指向 JDK 安装目录，且 PATH 环境变量包含 javac 和 jar 命令。示例命令：
echo $JAVA_HOME
echo $PATH
javac -version
jar --version若要在 Windows 上检查，请使用 set JAVA_HOME 和 echo %PATH%，以及 javac -version 与 jar。
输出目标目录的约定
为了保持清晰的构建结构，建议定义一个明确的 输出目录，例如 build/classes 用于编译后的类文件，build/jar 用于最终打包的 JAR。规定输出目录有助于后续对 打包路径 与 资源引入 的管理。
逐步编译到指定目录
准备源码与目录结构
确保源码具备标准的 Java 包结构，例如 src/com/example/App.java，对应的字节码应输出到 build/classes。正确的目录结构能够避免 package 声明与实际路径不一致的问题。
你还需要一个简单的入口类，例如 public class App，并在其中定义 public static void main(String[] args) 作为程序入口。
将源码清单放在版本控制中，并避免将 build 目录纳入版本控制以保持干净的工作区。
使用 javac 指定输出目录
使用 javac 的 -d 选项将编译后的 .class 文件输出到目标目录，源代码位置可以通过通配符或清单文件列出。下面给出两种常见做法：直接列出源码，或使用 find/glob 自动化：
# 方法一：逐个文件编译
javac -d build/classes $(find src -name "*.java")# 方法二：指定源路径与输出目录
javac -d build/classes -sourcepath src $(ls src/**/*.java)执行过程中，错误信息会指向未找到的导入或包路径，请确保源码的包名与目录结构完全一致。也可以在命令中加入 —version 或 —Xlint 来获得更详细的警告。
验证编译结果
完成编译后，检查 build/classes 目录下的 .class 文件是否完整。可以使用 jar tf 来查看打包时包含的内容，确保入口类已被编译。
jar tf MyApp.jar | grep App
ls -l build/classes/com/example/App.class打包成 JAR 并输出到目标路径
创建或准备 Manifest 文件
若要通过单入口类启动应用，必须提供一个 Manifest 文件，声明 Main-Class。这是运行 java -jar 时的入口。Manifest 示例：
Manifest-Version: 1.0
Main-Class: com.example.App确保 Main-Class 行以换行结尾，且全程使用正斜杠分隔包路径。错误的入口类会导致 找不到主类 的运行时异常。
使用 jar 命令打包并指定输出目录
通过 jar 命令将 build/classes 中的字节码和资源打包成 JAR，并将产物输出到自定义目录，例如 dist。共享的做法是先创建中间目录，再将 Jar 文件放入其中。
# 假设目标输出目录为 dist
mkdir -p dist
jar cfm dist/MyApp.jar Manifest.txt -C build/classes/ .如果你需要将编译后的类文件与资源一起打包，确保资源也位于 build/classes 或在打包时用 -C 指定正确路径。打包命令中的 -C 会改变打包上下文目录，以便正确引用相对路径。
验证打包结果与可执行性
打包完成后，使用 jar tf 查看 JAR 的内容，确保所有需要的类与资源都已包含。在运行阶段，使用 java -jar 来测试入口。
jar tf dist/MyApp.jar | head
java -jar dist/MyApp.jar常见问题与故障排除
错误 不能找到主类或入口点
最常见原因是 Main-Class 未正确写入 Manifest.txt，或在打包时未通过 -C 指定正确的类路径。确保 Manifest 中的 Main-Class 与实际主类的包路径一致，并且打包时包含了 Main-Class 条目。
echo -e "Manifest-Version: 1.0\nMain-Class: com.example.App\n" > Manifest.txt
jar cfm dist/MyApp.jar Manifest.txt -C build/classes/ .
输出目录与目标目录不一致
如果你在程序中读取输出路径却发现文件不在指定目录，检查打包命令中对 dist 的引用是否正确、以及在打包时是否覆盖了同名文件。建议在脚本中将输出目录变量化以避免错位。
打包后运行报错 NoClassDefFoundError
这个问题通常出现在缺少资源或依赖类，尤其是当你用 Main-Class 指定入口，但实际类文件位于不同的包中。确认所有依赖都已打包，必要时把外部库打入 JAR（使用 MANIFEST 或构建工具的打包配置）。
跨平台与路径问题
在 Windows 与 Unix 系统之间，路径分隔符和文本换行符不同，打包脚本应尽量使用 相对路径 与 变量，以确保兼容。对带空格的路径，使用引号包裹，避免命令解析错误。
示例代码与命令片段
完整步骤的命令合集
以下为一个完整的示例流程，将源码编译输出到 build/classes, 再打包输出到 dist/MyApp.jar，并使用 Manifest 指定入口类为 com.example.App。
# 设置目录
export SRC_DIR=src
export BUILD_DIR=build/classes
export DIST_DIR=dist
export MAIN_CLASS=com.example.App# 确保输出目录存在
mkdir -p "$BUILD_DIR"
mkdir -p "$DIST_DIR"# 1) 编译
javac -d "$BUILD_DIR" -sourcepath "$SRC_DIR" $(find "$SRC_DIR" -name "*.java")# 2) 生成 Manifest
printf "Manifest-Version: 1.0\nMain-Class: %s\n" "$MAIN_CLASS" > Manifest.txt# 3) 打包
jar cfm "$DIST_DIR/MyApp.jar" Manifest.txt -C "$BUILD_DIR" .# 4) 运行测试
java -jar "$DIST_DIR/MyApp.jar"仅使用 Ant/Maven/Gradle 的简短示例
如果偏好使用构建工具，可以简单了解无前言的命令片段，帮助你理解输出目录的关系：
# Maven 的打包输出通常在 target 目录
mvn clean package
ls -l target/MyApp.jar# Gradle 的打包输出通常在 build/libs 目录
./gradlew clean build
ls -l build/libs/MyApp.jar