javac

Java 源码编译器

补充说明

javac 把 .java 源码编译成 .class 字节码。它需要正确的类路径和目录结构；日常项目通常由 Maven/Gradle 调用。

常用示例

javac Main.java
javac -d out src/com/example/Main.java
javac --release 17 -d out src/**/*.java
javac -cp lib/*.jar -d out src/com/example/*.java
javac -encoding UTF-8 -Xlint:all -Werror -d out src/**/*.java
javac -parameters -d out src/com/example/*.java

易错点与排错

• --release 同时约束 API 和字节码版本，比单独 -source/-target 更可靠。
• 包名必须和目录结构一致；package com.example; 要放在 com/example/ 下。
• -cp 是编译期依赖，运行期还要再给一次；两者不一致会在运行时报 NoClassDefFoundError。
• 源码文件编码不是 UTF-8 时要显式 -encoding，否则中文注释和字符串会乱码。
• 注解处理器会在编译期生成代码；缺少处理器时会出现“找不到符号”。
• -Xlint:all -Werror 适合 CI，但升级 JDK 后可能出现新警告。
• 预览特性需要 --enable-preview --release <版本>，运行时也要同样开启。
• 只编译单个文件不会自动编译它引用的同包源码；用通配符或构建工具。

相关命令

• java — 运行字节码
• jar — 打包
• mvn / gradle — 构建工具