使用C99标准库时，如何避免文件写入出错导致的数据丢失？

核心问题分析 #

fwrite()中途失败（如磁盘满、IO错误）确实会导致原文件部分覆盖损坏——因为标准库的缓冲机制可能已将部分数据写入磁盘，却未完成全部写入流程。双文件法是最可靠的解决思路，它能保证文件内容的原子性更新：要么完全更新为新数据，要么保留旧数据的完整状态。

双文件方案的选择 #

临时文件替换法（优先推荐） #

这是最简单高效的方案，核心流程如下：

• 把所有数据写入临时文件（比如给原文件名加.tmp后缀）
• 确认临时文件写入完整且数据已刷入磁盘后，用原子重命名操作替换原文件
• 任何步骤失败，直接删除临时文件，原文件不受影响

优势：无需复制旧文件，节省IO开销；逻辑简单，能最大程度保证原文件的完整性。

交替文件法 #

适合需要保留多版本数据的场景（比如用file_a和file_b交替作为主文件），但需额外维护版本标记（比如单独的元文件记录当前有效文件），读取时还要先判断哪个文件是最新的。对于仅需保留最新有效版本的场景，临时文件替换法更优。

重命名的检测与注意事项 #

C99标准库的rename()函数是实现原子替换的核心：

• 返回值为0表示重命名成功，此时原文件已被原子替换为临时文件内容
• 返回非0表示失败，可通过<errno.h>中的errno获取具体错误（比如EACCES权限不足、EBUSY文件被占用、ENOSPC磁盘空间不足等）
• 注意：同一文件系统内的rename操作是原子性的（这是主流系统的通用实现，C99虽未强制，但实际可依赖）；跨文件系统重命名可能会先复制再删除，无法保证原子性，需尽量避免。

纯C99实现示例 #

#include <stdio.h>
#include <stdlib.h>
#include <errno.h>
#include <string.h>

// 安全写入文件：原子更新，保证原文件不损坏
int safe_write_file(const char *filename, const void *data, size_t data_size) {
    // 构造临时文件名
    char tmp_filename[FILENAME_MAX];
    if (snprintf(tmp_filename, sizeof(tmp_filename), "%s.tmp", filename) >= sizeof(tmp_filename)) {
        fprintf(stderr, "Temp filename too long\n");
        return -1;
    }

    // 打开临时文件（二进制写入模式，避免文本转换）
    FILE *tmp_fp = fopen(tmp_filename, "wb");
    if (!tmp_fp) {
        fprintf(stderr, "Failed to create temp file: %s\n", strerror(errno));
        return -1;
    }

    // 写入全部数据
    size_t written = fwrite(data, 1, data_size, tmp_fp);
    if (written != data_size) {
        fprintf(stderr, "Write failed: wrote %zu/%zu bytes\n", written, data_size);
        goto cleanup_fail;
    }

    // 强制刷新缓冲区到磁盘，确保数据写入完成
    if (fflush(tmp_fp) != 0) {
        fprintf(stderr, "Flush temp file failed: %s\n", strerror(errno));
        goto cleanup_fail;
    }

    // 关闭临时文件（再次确认缓冲写入）
    if (fclose(tmp_fp) != 0) {
        fprintf(stderr, "Close temp file failed: %s\n", strerror(errno));
        tmp_fp = NULL; // 避免重复关闭
        goto cleanup_fail;
    }

    // 原子替换原文件
    if (rename(tmp_filename, filename) != 0) {
        fprintf(stderr, "Rename temp file failed: %s\n", strerror(errno));
        remove(tmp_filename);
        return -1;
    }

    return 0;

cleanup_fail:
    // 清理临时文件
    if (tmp_fp) fclose(tmp_fp);
    remove(tmp_filename);
    return -1;
}

关键细节说明 #

• 用"wb"模式打开文件：避免文本模式的换行符转换问题，保证字节数据原样写入
• 检查fwrite返回值：必须等于预期写入的字节数（示例中第二个参数为1，返回值即字节数），否则说明写入不完整
• 手动调用fflush：确保标准库的用户态缓冲全部刷入内核，fclose虽会自动刷新，但提前检查能更早发现错误
• 失败时清理临时文件：避免残留无效文件占用磁盘空间

内容的提问来源于stack exchange，提问作者basedchad21