必须确保源文件路径与package声明严格一致，否则javac会静默跳过编译或后续运行时报noclassdeffounderror；根本原因是javac以当前目录为源码根目录，按package名推导源文件应处的子目录结构，如package com.example;则源文件必须位于com/example/下，且须从其父目录执行javac com/example/xxx.java。
必须确保源文件路径与package声明严格一致，否则javac直接报错“找不到类”或静默失败。
为什么javac编译带package的文件会失败
常见现象是：写了package com.example.util;，但把StringUtils.java直接放在当前目录下，执行javac StringUtils.java后没报错也没生成.class；或者报error: class StringUtils is public, should be declared in a file named StringUtils.java——其实真正卡点不在类名，而在路径。
根本原因是：javac按package名推导输出路径，同时要求输入路径能反向映射回package结构。它不关心你当前在哪，只认“从哪开始找源码”这个起点。
-
javac默认以当前目录为source root，即“源码根目录” - 若源文件声明
package a.b.c;，它必须位于a/b/c/子目录下（Linux/macOS）或a\b\c\（Windows） - 如果放错位置，
javac要么跳过编译（无提示），要么在后续java运行时抛NoClassDefFoundError
正确编译命令和目录结构
假设你要编译一个com.example.App类：
- 源文件必须存放在路径：
com/example/App.java（注意不是./App.java） - 在
com的父目录下执行：javac com/example/App.java - 生成的
App.class会自动落在com/example/App.class，保持包层级
如果想指定输出目录（比如统一到out/）：
javac -d out com/example/App.java
这样App.class就会生成在out/com/example/App.class，-d参数才是控制class输出根目录的关键。
IDEA或VS Code里没问题，但命令行出错？
因为IDE默认把项目根目录设为source root，并自动识别src/main/java这类标准结构；而命令行不会猜——它完全依赖你传入的路径和-sourcepath等显式参数。
- 不要在
com/example/目录里直接运行javac App.java，这会让javac认为package是空的（即默认包） - 避免用
javac *.java批量编译跨包文件，容易漏掉依赖或路径错位 - 如果有依赖其他
package的类，需用-cp或-classpath指明类路径，例如：javac -cp out com/example/Main.java
容易被忽略的细节
package声明本身极其脆弱：
-
package语句必须是文件第一行非空白、非注释内容；前面多一个空格、一行//之后再换行写package，都可能被某些旧版javac拒绝 - 包名大小写敏感，
com.Example和com.example是两个不同包，对应目录名也必须小写 - Windows下路径分隔符用
/或\均可，但javac内部统一转为/处理，建议脚本中统一用/避免歧义 - 如果你用OpenJDK 17+且启用了模块系统（
module-info.java），还需确保package被exports声明，否则即使编译成功，运行时也可能IllegalAccessError
