java -jar 无法引用外部JAR是设计使然，因其强制以MANIFEST.MF中Class-Path为准并忽略-classpath参数；正确做法是改用-cp显式指定主类，或修改MANIFEST.MF添加相对路径依赖。
java -jar 无法引用外部 JAR 是设计使然
直接执行 java -jar app.jar 时，哪怕你加了 -classpath 或 -cp 参数，JVM 也会忽略——这是规范行为，不是 bug。因为 -jar 模式会强制以该 JAR 的 META-INF/MANIFEST.MF 中的 Class-Path 条目为唯一类路径来源，外部参数不生效。
正确做法：用 -cp 启动，显式指定主类
绕过 -jar 限制最直接的方式是不用它，改用 -cp（或 -classpath）手动拼接类路径，并明确写出主类全名：
java -cp "app.jar:lib/dependency1.jar:lib/dependency2.jar" com.example.MainApp
注意点：
-
app.jar必须在-cp列表里，否则找不到自身类 - 路径分隔符：Linux/macOS 用
:，Windows 用; - 依赖 JAR 必须是完整路径或相对于当前工作目录的路径
- 主类名
com.example.MainApp必须和app.jar内实际的Main-Class一致，不能省略
如果必须用 java -jar，就改 MANIFEST.MF
编辑 app.jar 内的 META-INF/MANIFEST.MF，添加 Class-Path 行（注意冒号后有一个空格）：
Class-Path: lib/dependency1.jar lib/dependency2.jar
然后确保目录结构匹配：
./app.jar ./lib/dependency1.jar ./lib/dependency2.jar
关键限制：
-
Class-Path只支持相对路径，不支持绝对路径或通配符（*） - JAR 文件名不能含空格，否则加载失败且无明确报错
- 修改完 MANIFEST 后需重新打包（
jar uf app.jar META-INF/MANIFEST.MF），不能只替换文件
javac 编译时引用第三方 JAR
编译阶段要用 -cp 告诉编译器去哪里找依赖的 class：
javac -cp "lib/dependency1.jar:lib/dependency2.jar" src/com/example/MainApp.java
常见误区：
- 只加
-cp编译成功，但运行时仍报NoClassDefFoundError——说明运行没配对的-cp - 误把 JAR 放进
$JAVA_HOME/jre/lib/ext目录试图“全局注册”：OpenJDK 9+ 已废弃ext机制，且该方式破坏隔离性，不推荐 - 用
java -cp "app.jar:*.jar" ...期望通配符展开：bash/zsh 不会自动 glob 展开*，得写成java -cp "app.jar:lib/*.jar"（仅 JDK 6+ 支持，且仅限单层目录）
真正容易被忽略的是：编译和运行的类路径必须逻辑一致。很多人调通了编译，却忘了运行时也要同步处理依赖位置——这不是环境问题，是流程断点。
