ClassLoader.getResource()返回URL而非文件路径，不可直接用于File构造；应优先用getResourceAsStream()流式读取，仅在必要时通过toURI()安全提取file协议下的绝对路径或解压至临时文件。
ClassLoader.getResource() 返回的是 URL，不是文件路径
直接调用 ClassLoader.getResource("config.json") 得到的是一个 URL 对象，比如 jar:file:/app.jar!/config.json 或 file:/home/user/project/src/main/resources/config.json。它**不保证是可访问的本地文件路径**，更不能直接传给 new File(url.toString()) —— 这在 Jar 包里会生成非法路径，导致 FileNotFoundException。
常见错误现象：
- 开发时 IDE 下能读，打包成 Jar 后报
NullPointerException（getResource()返回null） - 用
url.toURI().getPath()解析出带!/的字符串，再构造File失败 - 路径含空格或中文时，
URL#getPath()未解码，导致乱码或找不到文件
想获取“绝对路径”？先确认你是否真的需要
绝大多数场景下，你**不需要也不应该依赖资源的绝对磁盘路径**。资源可能根本不在文件系统中（如在 Jar、War、模块化 JAR、甚至远程类加载器里）。正确做法是用 getResourceAsStream() 流式读取。
只有极少数情况才需真实文件路径，例如：
立即学习“Java免费学习笔记（深入）”；
- 要将资源复制到临时目录并由外部命令（如 Python 脚本、ffmpeg）读取
- 调试时想快速定位资源在磁盘上的位置
- 使用某些只接受
String path的旧 API（如 Log4j 1.x 的PropertyConfigurator.configure(path)）
此时必须做运行时判断：资源是否在普通文件系统中？
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
安全提取 file:// 协议下的绝对路径
如果确定资源在 classpath 的文件目录中（非 Jar），可用以下方式提取真实路径：
URL resource = MyClass.class.getClassLoader().getResource("logback.xml");
if (resource != null && "file".equals(resource.getProtocol())) {
try {
File file = new File(resource.toURI()); // toURI() 自动解码空格/中文
String absolutePath = file.getAbsolutePath();
System.out.println(absolutePath);
} catch (URISyntaxException e) {
// 不应发生，但需捕获
}
}
关键点：
- 必须检查
resource != null，否则 NPE - 必须检查
"file".equals(resource.getProtocol())，跳过jar:、jrt:等协议 - 用
toURI()而非getPath()，避免 URL 编码问题（如空格变成%20） - 不要用
new File(resource.toString())——toString()返回完整 URL 字符串，含协议头
Jar 包内资源无法获得“绝对路径”，只能解压到临时目录
当 getResource() 返回类似 jar:file:/app.jar!/application.properties 的 URL 时，file:/app.jar 是 Jar 文件路径，但 application.properties 并非独立文件 —— 它是 Zip 条目。此时没有“绝对路径”概念。
若强行需要文件路径（比如传给不支持流式输入的库），唯一可靠方式是：
- 用
getResourceAsStream()读取内容 - 写入
Files.createTempFile()创建临时文件 - 用完后记得
deleteOnExit()或手动清理（尤其服务长期运行时）
示例：
InputStream is = MyClass.class.getClassLoader().getResourceAsStream("schema.sql");
Path tempFile = Files.createTempFile("schema-", ".sql");
Files.copy(is, tempFile, StandardCopyOption.REPLACE_EXISTING);
String tempPath = tempFile.toAbsolutePath().toString(); // ✅ 这才是真正的绝对路径
// ... 使用 tempPath ...
tempFile.toFile().deleteOnExit();
真正容易被忽略的是：资源位置与部署形态强耦合。同一段代码，在 IDE、Spring Boot fat jar、JLink 构建的镜像、模块路径（--module-path）下，getResource() 行为都不同。别假设“它一定在某个目录下”。
