推荐使用 System.getProperty("line.separator") 获取系统原生换行符，因其自动适配运行环境（Windows 返回"\r\n"，Linux/macOS 返回"\n"），避免硬编码导致跨平台显示异常。
Java 中通过 System.getProperty("line.separator") 获取换行符，是确保文本在不同操作系统（Windows、Linux、macOS）中正确换行的推荐方式。它返回当前 JVM 所在系统的原生换行序列，无需硬编码 "\n" 或 "\r\n"。
为什么不能直接用 "\n"？
虽然 "\n" 在大多数 Java 场景中能被多数终端和编辑器识别，但它并非所有平台的**真实系统换行符**：
- Windows 使用
"\r\n"（回车+换行）作为标准换行符； - Linux 和 macOS 使用
"\n"； - 若程序生成文件供 Windows 记事本打开，仅用
"\n"会导致所有内容显示为一行（记事本不识别 Unix 换行）； -
System.getProperty("line.separator")会自动适配运行环境，更可靠。
如何安全获取并使用 line.separator
调用方式简单，但需注意空值和使用时机：
- 该属性始终有定义，不会返回
null，JVM 保证其存在； - 建议提取为静态常量，避免重复调用（虽开销极小，但语义清晰）：
private static final String NL = System.getProperty("line.separator"); - 拼接多行字符串时，优先用
String.join(NL, lines)或lines.stream().collect(Collectors.joining(NL))，比循环 ++=更高效安全。
替代方案对比：Platform.isWindows() 等是否更好？
手动判断系统类型再指定换行符（如用 Apache Commons Lang 的 SystemUtils.LINE_SEPARATOR 或自己判断）并不必要：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
立即学习“Java免费学习笔记（深入）”；
-
System.getProperty("line.separator")是 JDK 原生支持，零依赖； - 它反映的是 **JVM 运行时实际环境**，而非编译时或开发机环境——例如在 Linux 上打包的 jar，在 Windows 上运行时自动返回
"\r\n"； - 第三方工具类底层通常也是封装了同一系统属性，无实质优势。
实际使用示例
生成带换行的配置文件内容：
String config = "host=localhost" + NL
+ "port=8080" + NL
+ "debug=true";
或更推荐使用 String.format 或 TextBlock（Java 15+）配合 NL：
String config = String.format("host=%s%sport=%d%sdebug=%b",
host, NL, port, NL, debug); 
