根本原因是未配对使用StandardOpenOption.WRITE——APPEND仅控制写入位置，不提供写权限；漏掉WRITE会抛AccessDeniedException或静默失败，漏掉CREATE且文件不存在则抛NoSuchFileException。
用 StandardOpenOption.APPEND 实现追加写入时，为什么文件没新增内容？
根本原因通常是没配对使用 StandardOpenOption.WRITE —— APPEND 本身不隐含写权限，只是控制写入位置。JVM 会直接抛 java.nio.file.AccessDeniedException 或静默失败（取决于底层实现），尤其在 Windows 上容易误判为“写入成功但没效果”。
正确组合只有两种：
-
StandardOpenOption.WRITE, StandardOpenOption.APPEND（追加，文件必须存在） -
StandardOpenOption.WRITE, StandardOpenOption.CREATE, StandardOpenOption.APPEND（追加，不存在则创建）
漏掉 CREATE 且文件不存在时，会抛 NoSuchFileException；漏掉 WRITE 则根本无法打开通道。
StandardOpenOption.TRUNCATE_EXISTING 和覆盖写入的关系
它不是“覆盖写入”的开关，而是“打开时清空文件”的指令。必须和 WRITE 一起用，且仅在文件已存在时生效。如果文件不存在，TRUNCATE_EXISTING 会被忽略（除非同时用了 CREATE，否则仍会报错）。
常见错误写法：TRUNCATE_EXISTING, CREATE —— 这会导致新文件被创建后立刻清空（看似冗余），但若想“存在就覆盖、不存在就新建”，正确组合是：
StandardOpenOption.WRITE, StandardOpenOption.CREATE, StandardOpenOption.TRUNCATE_EXISTING
注意：这个组合在 JDK 11+ 中行为稳定；JDK 8 某些补丁版本中，TRUNCATE_EXISTING 对符号链接处理有差异，生产环境建议显式检查 Files.isRegularFile()。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
追加 vs 覆盖：选错选项导致的典型异常
实际调试中最常遇到的三个错误信息，基本能反推配置问题：
-
AccessDeniedException: … (Read-only file system)→ 漏了WRITE，或文件系统只读 -
NoSuchFileException: …→ 想追加但没加CREATE，且文件不存在；或想覆盖但没加CREATE，且文件不存在 -
FileAlreadyExistsException: …→ 用了CREATE_NEW但文件已存在（这个选项和APPEND/TRUNCATE_EXISTING互斥，别混用）
建议在打开前加一行日志：Files.exists(path)，避免把路径拼错当成选项问题。
性能与线程安全提醒
APPEND 模式下，每次写入都会先 seek 到 EOF，频繁小写入（如每条日志单独 write）比批量写入慢 2–5 倍（实测 SSD 环境）。如果日志量大，优先用 BufferedWriter 包裹，而不是依赖通道自动缓冲。
多个线程共用同一个 FileChannel 并发追加，不会自动加锁 —— APPEND 只保证“写入位置是当前 EOF”，不保证原子性。两线程同时写，可能出现内容交错。真正需要并发追加，得自己用 FileLock 或改用 java.util.logging 等线程安全的日志框架。
最易被忽略的一点：StandardOpenOption 是静态常量，但它们的语义高度依赖组合顺序和配套选项——单看一个选项名，几乎无法判断最终行为。
