java 中可以使用 java.nio.file.files 类的静态方法将字符串写入文件。最常用的是 files.writestring()，它直接接受路径、字符串内容和可选的选项参数，自动处理字符编码和文件创建。若需追加内容或指定特定编码（如 utf-8），可通过传入 standardopenoption.append 或 standardcharsets.utf_8 等参数实现。
writeString() 覆盖写入与默认编码行为是怎样的
Files.writeString() 在默认情况下会覆盖目标文件内容，并使用平台默认字符集进行编码。如果文件不存在则自动创建，存在则清空后重写。该方法是 Java 11 引入的便捷 API，底层封装了 OutputStreamWriter 和缓冲机制，无需手动管理流资源。
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.StandardOpenOption;
import java.nio.charset.StandardCharsets;
public class FileWriteExample {
public static void main(String[] args) throws Exception {
Path filePath = Path.of("output.txt");
String content = "Hello, World!";
// 覆盖写入，使用 UTF-8 编码
Files.writeString(filePath, content, StandardOpenOption.CREATE,
StandardOpenOption.TRUNCATE_EXISTING,
StandardOpenOption.WRITE);
System.out.println("File written successfully.");
}
}
运行上述代码后，output.txt 将被创建并包含文本 Hello, World!。若文件已存在，其原有内容会被清除。返回值类型为 long，表示写入的字节数，但通常开发者不依赖此返回值，除非需要验证实际写入量。
掌握 ES6+ 特性，包括 async/await、解构、扩展运算符、箭头函数、Promise、模块、迭代器、生成器以及函数式编程模式，编写简洁高效的 Java
立即学习“Java免费学习笔记（深入）”；
如何追加字符串到现有文件而不覆盖原内容
要实现追加写入，需在调用 Files.writeString() 时传入 StandardOpenOption.APPEND 选项，同时保留 CREATE 以确保文件不存在时能新建。此时不会截断已有内容，新字符串将接在原文件末尾。注意：若未指定编码，仍使用平台默认编码，可能导致跨平台乱码，建议显式指定 UTF_8。
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.StandardOpenOption;
import java.nio.charset.StandardCharsets;
public class AppendToFileExample {
public static void main(String[] args) throws Exception {
Path filePath = Path.of("output.txt");
String newLine = "\nAppended line.";
// 追加模式，UTF-8 编码
Files.writeString(filePath, newLine, StandardOpenOption.CREATE,
StandardOpenOption.APPEND,
StandardOpenOption.WRITE);
System.out.println("Content appended.");
}
}
假设 output.txt 初始内容为 Hello, World!，执行追加操作后，文件内容变为：Hello, World!Appended line.
该方法返回写入的字节数，此处为新增部分的字节长度。若文件为空，则仅写入新内容。所有操作均原子性完成，无需担心部分写入导致的数据损坏。
当目标路径指向一个已存在的目录时会发生什么
若尝试将字符串写入一个已存在的目录路径（而非文件），Files.writeString() 会抛出 java.nio.file.FileAlreadyExistsException。这是因为 NIO.2 API 要求目标必须是普通文件或可创建的符号链接，不能是目录。即使传入 CREATE 选项也无法绕过此限制，因为操作系统不允许向目录写入数据。开发者应确保路径指向合法的文件位置，或在写入前检查路径类型以避免异常。
