命令行编译Java工程是Java开发中的基础技能，掌握它有助于理解Java程序的编译和运行机制，尤其在没有集成开发环境（IDE）或需要自动化构建的场景中尤为重要，以下是详细的步骤和注意事项,帮助您顺利完成Java工程的命令行编译。
准备工作
在开始编译之前，确保您的系统已安装Java开发工具包（JDK），并且环境变量配置正确,具体步骤如下：
- 检查JDK安装：打开命令行工具（如Windows的cmd或PowerShell，Linux的终端），输入
java -version和javac -version，如果显示版本信息，则说明JDK已安装；否则需下载并安装JDK（推荐Oracle JDK或OpenJDK）。 - 配置环境变量：将JDK的
bin目录添加到系统的PATH变量中，在Windows中，右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”中找到Path变量，添加JDK的bin路径（如C:\Program Files\Java\jdk-17\bin），在Linux中，编辑~/.bashrc或~/.profile文件，添加export PATH=$PATH:/usr/lib/jvm/java-17-openjdk-amd64/bin，然后运行source ~/.bashrc使配置生效。
Java工程结构
一个典型的Java工程包含以下文件和目录：
- 源代码文件：以
.java存放在src目录下。src/com/example/HelloWorld.java。 - 资源文件：如配置文件、图片等，可存放在
resources目录下。 - 依赖库：第三方JAR包，通常存放在
lib目录下。 - 编译输出目录：编译后的
.class文件存放位置，通常为bin或target目录。
假设工程结构如下：
MyProject/
├── src/
│ └── com/
│ └── example/
│ └── HelloWorld.java
├── lib/
│ └── commons-lang3-3.12.0.jar
└── bin/编译步骤
编译单个Java文件
如果工程只有一个源文件，可直接使用javac命令编译：
javac src/com/example/HelloWorld.java
编译成功后，会在src/com/example/目录下生成HelloWorld.class文件。
编译整个源代码目录
对于包含多个源文件的工程，使用javac的-d选项指定编译输出目录，-cp或-classpath选项指定依赖库路径。
javac -d bin -cp "lib/*" src/com/example/*.java
-d bin：将编译后的.class文件输出到bin目录。-cp "lib/*"：包含lib目录下的所有JAR包作为依赖。src/com/example/*.java：编译src/com/example目录下的所有.java文件。
处理包结构
Java使用包（package）管理类，编译时需确保包结构与源代码路径一致。HelloWorld.java包含package com.example;，则文件必须存放在src/com/example/目录下，编译后的.class文件会自动生成com/example/子目录。
编译时注解处理
如果使用注解处理器（如Lombok、DataProcessor），需通过-processor选项指定处理器类，并通过-classpath包含其依赖。
javac -d bin -cp "lib/*:lib/annotation-processor.jar" -processor com.example.MyProcessor src/com/example/*.java
源文件编码和版本控制
- 指定源文件编码：
javac -encoding UTF-8 -d bin src/com/example/*.java。 - 指定JDK版本：
javac -source 1.8 -target 1.8 -d bin src/com/example/*.java。
常见编译问题及解决方法
| 问题现象 | 可能原因 | 解决方法 |
|---|---|---|
javac: command not found |
JDK未安装或未配置PATH | 检查JDK安装并配置环境变量 |
错误: 找不到符号 |
依赖库未引入或类名错误 | 使用-cp选项添加依赖库，检查类名拼写 |
错误: 编码GBK的不可映射字符 |
源文件编码与系统默认编码不一致 | 使用-encoding选项指定编码（如UTF-8） |
错误: 程序包不存在 |
包路径错误或依赖缺失 | 检查package声明，确保依赖库在-cp中 |
运行编译后的程序
编译成功后，使用java命令运行程序，注意需指定包含main方法的类的全限定名，并设置classpath为编译输出目录：
java -cp "bin:lib/*" com.example.HelloWorld
-cp "bin:lib/*"：包含bin目录和lib下的所有JAR包。com.example.HelloWorld：全限定类名（包含包路径）。
自动化编译脚本
为简化编译过程，可编写批处理脚本（Windows）或Shell脚本（Linux），Windows下的compile.bat：
@echo off
set SRC_DIR=src
set BIN_DIR=bin
set LIB_DIR=lib
javac -d %BIN_DIR% -cp "%LIB_DIR%/*" %SRC_DIR%\com\example\*.java
if %ERRORLEVEL% NEQ 0 (
echo 编译失败！
pause
exit /b 1
)
echo 编译成功！
pause
Linux下的compile.sh：
#!/bin/bash
SRC_DIR="src"
BIN_DIR="bin"
LIB_DIR="lib"
javac -d "$BIN_DIR" -cp "$LIB_DIR/*" "$SRC_DIR"/com/example/*.java
if [ $? -ne 0 ]; then
echo "编译失败！"
exit 1
fi
echo "编译成功！"
相关问答FAQs
问题1：为什么编译时提示“错误: 找不到符号”，但依赖库已添加到-cp中？
解答：可能的原因包括：
- 依赖库的JAR包未包含所有必需的类（如JAR文件损坏或版本不匹配）。
- 类的全限定名错误（如大小写敏感或包路径错误）。
- 依赖库的路径未正确解析（如路径中包含空格未用引号括起）。
建议检查依赖库完整性，并尝试使用绝对路径指定-cp。
问题2：如何编译包含模块（Java 9+）的工程？
解答：对于模块化工程（使用module-info.java），需使用javac的--module-source-path和--module选项。
javac --module-source-path src --module-path lib -d bin --module mymodule src/com/example/*.java
--module-source-path指定模块源码路径，--module-path指定模块依赖路径，mymodule是模块名（需与module-info.java中的声明一致）。
