CLASSPATH 环境变量没生效？先看 Java 是不是根本没读它
Java 8 及以后版本默认忽略 CLASSPATH 环境变量，除非显式加了 -cp 或 -classpath 参数。这不是配置错了，是设计如此——JVM 启动时若没指定类路径，会直接用当前目录（.）和 rt.jar 等系统类库，完全跳过环境变量。
- 验证方式：运行
java -XshowSettings:properties -version 2>&1 | grep class.path，看输出里java.class.path的值是否含你设的路径 - 开发阶段建议绕过环境变量，统一用
java -cp "lib/*:." MyApp（注意 Windows 用分号;分隔） - 如果非要用环境变量，得加
-Djava.class.path=...覆盖，但容易和 IDE 或构建工具冲突，不推荐
用 -cp 指定多个 JAR 时，通配符 * 不递归、不匹配子目录
* 在 -cp 中只展开同级目录下的所有 .jar 和 .JAR 文件，不会进 lib/utils/ 这类子目录，也不会加载 .zip 或无后缀文件。
- 错误写法：
-cp "lib/*"但实际 JAR 在lib/dep/spring-core-5.3.30.jar→ 找不到类 - 正确做法：把依赖全平铺到同一级（如 Maven 的
mvn dependency:copy-dependencies），或手动拼路径：-cp "lib/spring-core.jar:lib/commons-lang3.jar:." - Windows 下注意分号分隔：
-cp "lib\*;."，且 CMD 对引号和通配符解析更脆弱，建议优先用 PowerShell 或脚本封装
IDE 和命令行的 CLASSPATH 完全是两套体系
IntelliJ/Eclipse 的「Module Dependencies」或「Run Configuration」里的类路径，和系统 CLASSPATH 环境变量、甚至 java -cp 都不共享。IDE 启动 JVM 时会自动生成完整 -cp 参数，把你项目源码、Maven 依赖、输出目录全塞进去。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
- 现象：在 IDEA 里跑得好好的，终端执行
java MyApp就报NoClassDefFoundError→ 因为没带任何-cp - 导出可运行 JAR 时，IDE 默认不打包依赖（除非选「Extract to target JAR」或「Copy to lib」），生成的 MANIFEST.MF 里
Class-Path:字段才是关键 - 检查 MANIFEST.MF：用
jar -tf myapp.jar | grep MANIFEST，再jar -xf myapp.jar META-INF/MANIFEST.MF && cat META-INF/MANIFEST.MF
Java 9+ 模块系统让 CLASSPATH 彻底退居二线
一旦用了 module-info.java，JVM 就进入模块模式（--module-path 优先），此时 CLASSPATH 只负责加载「未命名模块」里的类，且无法访问具名模块的包（哪怕加了 -cp）。
立即学习“Java免费学习笔记（深入）”；
- 典型报错：
java.lang.module.ResolutionException: Module xxx reads package yyy from both aaa and bbb→ 多个 JAR 提供同名包，模块系统拒绝加载 - 临时绕过：加
--add-modules ALL-SYSTEM或--add-opens，但这只是调试手段，不是解决方案 - 真正要做的：用
jdeps检查依赖树，删掉重复 JAR，或改用jlink构建最小运行镜像
CLASSPATH 的模糊性在现代 Java 里反而成了隐患——它不声明依赖边界，不校验版本，也不控制封装。真要稳定运行，与其死磕路径，不如让构建工具（Maven/Gradle）生成明确的启动脚本或 fat jar。
