Java文件读写出错主因是路径语义误用，关键在明确user.dir为相对路径起点、类路径资源须用getResource()、跨平台路径用Paths.get()、生产路径需外部化并校验。
Java 中文件读写出错，八成不是代码逻辑问题，而是路径语义被误用——尤其在相对路径和绝对路径之间反复横跳时。关键不在“怎么写”，而在“谁来解析、在哪解析、以谁为起点”。
看清 user.dir 才是相对路径的真正起点
写 new File("config.txt") 或 Paths.get("data/log.csv") 时，Java 不看你的 IDE 项目结构、不认 src 或 target 目录，只认 JVM 启动那一刻的 当前工作目录，也就是 System.getProperty("user.dir") 的值。
- 你在命令行进入
D:myapp后执行java -jar app.jar，那所有相对路径就从D:myapp开始算 - 你在 IDEA 里右键运行某个 Main 类，默认工作目录通常是项目根目录；但若配置了“Working directory”为
$MODULE_DIR$或$CONTENT_ROOT$，结果就可能不同 - Spring Boot 打包成 jar 后，在服务器上用
nohup java -jar app.jar &启动，user.dir就是你执行该命令时所在的目录，未必是 jar 所在目录
资源文件别用 File，要用 getClass().getResource()
放在 src/main/resources 下的配置文件、模板、图片等，本质是类路径（classpath）资源，不是文件系统中的普通文件。硬用 new File("conf/app.properties") 去读，打包后必然失败。
- 读取类路径下的资源，统一用
getClass().getResource("/conf/app.properties")（带斜杠表示从 classpath 根开始）或getClass().getResource("app.properties")（不带斜杠表示相对于当前类所在包） - 返回的是
URL对象，可转为InputStream直接读取，不涉及文件系统路径解析 - 如果需要转成
File（极少数场景），得先判断 URL 协议是否为file，再用url.toURI()转换，不能直接字符串拼接
跨平台路径拼接别手写斜杠，用 Paths.get()
写 "config" + File.separator + "app.properties" 或硬写 "config\app.properties" 都容易翻车。Windows 和 Linux 对分隔符容忍度不同，但更危险的是语义混淆：你写的看似是“路径字符串”，实际却可能被当成抽象路径或 URI 片段。
- 一律使用
Paths.get("config", "app.properties")—— 它自动适配系统分隔符，并返回标准Path对象 - 组合路径时避免字符串拼接，比如从 baseDir 加子路径，用
basePath.resolve("sub").resolve("file.txt") - 如果必须从字符串构造，确保用正斜杠
/（Java 内部全支持），不要用反斜杠，更不要混用
生产环境路径必须外部化 + 显式校验
硬编码路径在开发机上能跑，上线就崩，根本原因是把“路径位置”当成了代码的一部分。它其实是部署配置，应与代码分离。
- 通过 JVM 参数（
-Dconfig.path=/opt/myapp/conf）、环境变量（CONFIG_PATH）或配置中心注入路径 - 启动时立即校验：
Files.exists(Paths.get(configPath))，不存在就抛明确异常，而不是等到第一次读文件才报错 - 日志中打印解析后的绝对路径，例如：
logger.info("Loading config from: {}", configPath.toAbsolutePath())，便于快速定位问题
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
