-sourcepath 是 javac 的命令行选项，用于指定源码根目录，使编译器能根据包名自动定位并编译依赖的 .java 文件；它只查找源码，不替代显式编译路径，支持多路径分隔，未设置时默认仅搜索当前目录。
配置 Source Path（源路径）是 Java 编译的第一步，它告诉 javac 编译器：「你该去哪儿找被 import 的类的源代码」。这和 -classpath（找已编译的 .class）不同，-sourcepath 专用于定位 .java 源文件，尤其在不使用 IDE 或构建工具、纯命令行编译时至关重要。
Source Path 是什么？
-sourcepath 是 javac 的一个命令行选项，用于指定源码根目录。编译器会根据包名（如 foo.Testfoo）自动拼接路径（如 src/foo/Testfoo.java），只要该文件存在于你指定的 -sourcepath 下，就能被自动发现并参与编译——哪怕它还没被编译过。
关键点：
• 它只影响「依赖的源文件」查找，不影响当前要编译的那个 .java 文件的路径（那个路径必须显式写出）；
• 支持多个路径，用分号（Windows）或冒号（macOS/Linux）分隔；
• 若未指定 -sourcepath，编译器默认只在当前目录及其子目录中搜索源文件，容易失败。
什么时候必须用 -sourcepath？
当你遇到类似 error: cannot find symbol，且错误指向的是你自己写的、但没和当前文件放同一目录的类时，大概率就是缺了 -sourcepath。典型场景包括：
- 项目按标准结构组织（如
src/main/java/com/example/A.java和src/main/java/com/example/util/B.java），而你在src/main/java外执行编译； - 多个包分散在不同目录，但又不想提前全部编译；
- 想让 javac 自动编译依赖项（比如 A.java 引用了 B.java，只编译 A 就连带编译 B）。
怎么正确设置 -sourcepath？
记住一个原则：把「最顶层的包目录的父目录」作为 -sourcepath 值。例如：
立即学习“Java免费学习笔记（深入）”；
你的目录结构是：
project/ ├── src/ │ ├── com/ │ │ └── app/ │ │ └── Main.java // package com.app; │ └── util/ │ └── Helper.java // package util;
那么你应该在 project 目录下运行：
javac -sourcepath src -d classes src/com/app/Main.java
说明：
• -sourcepath src 告诉编译器：所有 package xxx 的源文件，都从 src 开始找；
• Main.java 中若 import util.Helper;，编译器就会去 src/util/Helper.java 找并自动编译它；
• -d classes 指定生成的 .class 输出到 classes 目录，避免污染源码。
常见误区与避坑提示
• 不要把 .java 文件路径本身当作 -sourcepath —— 比如不要写 -sourcepath src/com/app，否则 util.Helper 就找不到；
• -sourcepath 和 -classpath 可同时存在，互不干扰：前者管「源码在哪」，后者管「编译好的类在哪」；
• 如果依赖的是第三方 JAR 包里的类，不需要也不应该放进 -sourcepath，那是 -classpath 或 -cp 的职责；
• Windows 下路径分隔符用分号 ;，Linux/macOS 用冒号 :，写错会导致整个路径失效。
