javac是JDK自带编译器,需配置PATH且依赖正确目录结构与包声明;多文件编译用-d指定输出目录,-cp控制外部依赖;常见错误多源于路径、命名或版本不匹配。

在Java中,使用javac命令编译源代码是进入JVM世界的第一步。它不是简单地把.java文件“转成”.class,而是一套有明确阶段、依赖规则和路径逻辑的流程。
javac的基本用法与必要条件
javac是Java Development Kit(JDK)自带的编译器,必须确保系统PATH中已配置JDK的bin目录,且运行的是JDK而非仅JRE。最简编译命令为:
javac HelloWorld.java
成功后会在当前目录生成HelloWorld.class。注意:
- 源文件名必须与public类名完全一致(包括大小写);
- 若类声明为public class Demo,文件名必须是Demo.java;
- 一个.java文件中最多只能有一个public类。
处理多文件与包结构的编译
当项目含多个类或使用package时,目录结构必须匹配包声明。例如:
立即学习“Java免费学习笔记(深入)”;
src/com/example/Utils.java
src/com/example/App.java
其中Utils.java开头为package com.example;。此时需从src目录外执行:
javac -d classes src/com/example/*.java
说明:
- -d classes指定输出目录(会自动创建classes/com/example/);
- 路径要体现完整包结构,不能在src内直接运行javac *.java;
- 若App.java引用了Utils,javac会自动查找并编译依赖的.java(只要路径可访问)。
常见编译错误与排查要点
编译失败通常不因语法错,而源于环境或路径问题:
- “error: cannot find symbol”:多半是类没编译、类路径不对,或包名/目录不匹配;
- “error: class XXX is public, should be declared in a file named XXX.java”:文件名与public类名不符;
- “javac: file not found”:路径写错,或用了中文路径、空格未加引号;
-
“unsupported class file version”:javac版本高于目标JRE,可用
-source和-target指定兼容版本,如javac -source 8 -target 8 Main.java。
进阶:通过-classpath控制依赖查找
当引用外部jar(如gson-2.10.jar)或已编译的class时,必须显式告知javac位置:
javac -cp ".;lib/gson-2.10.jar" -d bin src/Main.java
说明:
- -cp(或-classpath)设置编译期类路径;
- Windows用分号;分隔,Linux/macOS用冒号:;
- 当前目录.要显式加入,否则默认不查;
- -cp只影响编译,不影响后续java命令运行——运行时仍需单独指定-cp。











