此 crate 支持所有主要平台，包括：Unix 系统、Windows 和 WASI。

动机和示例

考虑以下代码片段，用于以 JSON 格式写入配置文件：

use std::io::Write;
use std::fs::File;

let mut file = File::options()
                    .write(true)
                    .create(true)
                    .open("config.json")?;

writeln!(file, "{{")?;
writeln!(file, "  \"key1\": \"value1\",")?;
writeln!(file, "  \"key2\": \"value2\"")?;
writeln!(file, "}}")?;

此代码打开一个名为 config.json 的文件，如果文件已存在，则截断其内容，并逐行写入 JSON 内容。

如果在所有 writeln! 调用完成之前代码被中断（因为恐慌、收到信号、进程被杀死或文件系统错误），则文件将处于损坏状态：它将不包含有效的 JSON 数据，并且将丢失原始内容（如果有的话）。

AtomicWriteFile 通过仅在完全写入到文件系统后将其新内容放入目标文件来解决此问题。上面的代码片段可以使用 AtomicWriteFile 替换 File 来重写，如下所示：

use std::io::Write;
use atomic_write_file::AtomicWriteFile;

let mut file = AtomicWriteFile::options()
                               .open("config.json")?;

writeln!(file, "{{")?;
writeln!(file, "  \"key1\": \"value1\",")?;
writeln!(file, "  \"key2\": \"value2\"")?;
writeln!(file, "}}")?;

file.commit()?;

注意，此代码与原始代码几乎相同，只是现在使用 AtomicWriteFile 替换 File，并且有一个额外的对 commit() 的调用。