Java 编程第一步：如何配置编译和运行的 Source Path

聊到 Ja va 编译，很多新手甚至一些有经验的开发者，在命令行下编译带包结构的项目时，经常会撞上“找不到符号”的错误。这时候，多半是 -sourcepath 没配好。

-sourcepath 其实是 ja vac 的一个命令行选项，用来告诉编译器：所有被 import 的类的源码，要去哪里找。这和 -classpath 的职责完全不同——后者只管已经编译好的 .class 文件或 JAR 包，而 -sourcepath 只盯源码（.ja va）。在不依赖 IDE 或构建工具（比如 Ma ven、Gradle），纯靠命令行编译时，这个选项就成了避免编译链断裂的关键。

到底什么是 Source Path？

简单说，-sourcepath 就是给 ja vac 指明源码根目录。编译器拿到这个路径后，会根据包名自动拼接出子路径。比如一个类的全限定名是 foo.Testfoo，编译器就会去 指定的-sourcepath路径/foo/Testfoo.ja va 找这个文件。只要文件存在，哪怕它还没被编译过，编译器也会自动把它拉进来一起编译。

这里面有几个要点需要注意：

• 它只影响“被依赖的源文件”，不影响你当前显式要编译的那个 .ja va 文件——后者必须把完整路径写在命令里。
• 支持多路径，Windows 下用分号 ; 分隔，macOS/Linux 下用冒号 :，写错了路径会直接失效。
• 如果不设 -sourcepath，编译器默认只会在当前目录及其子目录里扫源码，稍微复杂一点的项目结构就容易编译失败。

什么时候非用它不可？

当你在编译时遇到 error: cannot find symbol，而且报错指向的是你自己写的类、却和当前文件不在同一个目录时，基本就是缺了 -sourcepath。典型场景包括：

• 项目按标准结构组织，比如 src/main/ja va/com/example/A.ja va 和 src/main/ja va/com/example/util/B.ja va，而你是在 src/main/ja va 的父目录外面执行编译。
• 多个包分散在不同的目录里，你又不想提前把所有文件都编译一遍。
• 想让 ja vac 自动搞定依赖——比如 A.ja va 引用了 B.ja va，你只编译 A.ja va，编译器顺带就把 B.ja va 也编译了。

正确的配置姿势

核心原则很直观：把“最顶层的包目录的父目录”设成 -sourcepath 的值。举个例子：

假设你的目录结构是这样的：

project/
├── src/
│   ├── com/
│   │   └── app/
│   │       └── Main.ja va     // package com.app;
│   └── util/
│       └── Helper.ja va       // package util;

那你就应该在 project 目录下执行：

ja vac -sourcepath src -d classes src/com/app/Main.ja va

解释一下：

• -sourcepath src 就是告诉编译器：所有 package xxx 的源文件，都从 src 这个根开始找。
• Main.ja va 里如果写了 import util.Helper;，编译器会自动去 src/util/Helper.ja va 找到它并编译。
• -d classes 用来指定生成的 .class 文件输出到 classes 目录，避免污染源码目录，是个好习惯。

容易踩的坑

• 不要把 .ja va 文件的目录路径直接当 -sourcepath 用。比如写成 -sourcepath src/com/app，那 util.Helper 就找不到了，因为编译器会到 src/com/app/util/Helper.ja va 这种路径去找——显然不对。
• -sourcepath 和 -classpath 可以共存，互不冲突。前者管源码位置，后者管已编译的类或 JAR 包。如果依赖的是第三方 JAR 包，那应该走 -classpath，别往里塞 -sourcepath。
• 路径分隔符别写错，尤其在 Windows 上，分号和冒号搞混了整个路径都会失效，这是个非常隐蔽的坑。