StringBuilder需借助字符流写入文件：推荐用OutputStreamWriter+FileOutputStream指定UTF-8编码，配合try-with-resources自动管理资源；避免直接用FileOutputStream写getBytes()导致乱码，勿忘flush()，换行用System.lineSeparator()。
StringBuilder 本身不直接处理 I/O，它只是高效拼接字符串的工具。要把 StringBuilder 的内容写入本地文件，需借助字符流（如 FileWriter 或更推荐的 OutputStreamWriter 配合 FileOutputStream），并注意编码、资源关闭和异常处理。
用 FileWriter 写入文件（简单场景）
适合默认编码（通常是系统编码）且内容不复杂的情况。注意 FileWriter 默认使用平台默认字符集，中文可能乱码，建议显式指定编码（Java 11+ 支持构造时传 Charset）。
- 创建
StringBuilder并拼接内容 - 用
FileWriter（带true参数可追加）或FileWriter(file, StandardCharsets.UTF_8)（Java 11+）打开文件 - 调用
write(sb.toString())，再flush()和close() - 强烈建议用 try-with-resources 自动释放资源
用 OutputStreamWriter + FileOutputStream（推荐，可控编码）
这是更通用、更可靠的方式，能明确指定 UTF-8 等编码，避免乱码，也兼容老版本 JDK。
- 将
StringBuilder转为字符串：sb.toString() - 用
FileOutputStream打开文件，再包装成OutputStreamWriter并指定StandardCharsets.UTF_8 - 写入后必须
flush()（确保缓冲区内容落盘），try-with-resources 会自动close() - 示例关键代码：
try (OutputStreamWriter writer = new OutputStreamWriter(
new FileOutputStream("output.txt"), StandardCharsets.UTF_8)) {
writer.write(sb.toString());
writer.flush();
}
避免常见错误
容易踩坑的地方：直接用字节流（如 FileOutputStream.write(byte[])）写入 sb.toString().getBytes() 不指定编码，会导致乱码；忘记 flush() 可能内容没真正写入；未用 try-with-resources 导致文件句柄泄漏。
立即学习“Java免费学习笔记（深入）”；
- 不要用
sb.toString().getBytes()丢给FileOutputStream—— 缺少编码声明 - 不要手动调用
close()后再写入 —— 会抛IOException - 大文本拼接后一次性写入即可，无需逐行 write —— StringBuilder 已完成组装，流只负责输出
如果需要按行写入或追加
可在 StringBuilder 中预先加入 "\n"，或在每次 write() 后调用 writer.write("\n")；追加模式只需把 FileOutputStream("file.txt", true) 的第二个参数设为 true。
- 换行符尽量用
System.lineSeparator()提高跨平台兼容性 - 追加写入时，注意文件原有内容与新内容的逻辑衔接
- 高并发或多线程写同一文件？需额外加锁或改用日志框架 —— StringBuilder 本身不是线程安全的
