C语言实现按文件大小滚动存储：超阈值创新文件 最多7个后覆写首个

核心设计思路 #

这个需求本质是循环日志滚动（Round-Robin Log Rotation） 场景，核心需要维护3类关键状态，按固定流程判断是否触发文件滚动即可实现：

• 配置类常量：单文件大小阈值MAX_FILE_SIZE、最大文件数MAX_FILE_COUNT=7、统一文件命名前缀/后缀
• 运行时状态变量：
  • 当前正在写入的文件序号current_file_idx，取值范围0~6
  • 当前打开的文件指针FILE *current_fp
  • 当前已写入当前文件的字节数current_written_bytes（也可以每次写入前用ftell查文件大小，缓存字节数性能更优）

核心流程步骤 #

1. 初始化阶段

程序启动时可先扫描当前目录下符合命名规则的7个文件，按修改时间排序，找到最新的未写满的文件作为初始写入文件；如果没有任何历史文件则从序号0开始创建第一个文件。如果所有文件都已写满，直接从最早的序号开始覆盖写入即可。

2. 写入流程
   每次写入内容前先做判断：

• 计算本次要写入的字节数write_len
• 如果current_written_bytes + write_len > MAX_FILE_SIZE，触发文件滚动逻辑：
  • 关闭当前打开的文件fclose(current_fp)
  • 序号自增：current_file_idx = (current_file_idx + 1) % MAX_FILE_COUNT，通过取模实现序号循环
  • 以截断写模式（"wb"/"w"）打开新序号对应的文件，直接覆盖旧内容
  • 重置current_written_bytes为0
• 将内容写入当前文件，累加current_written_bytes += 实际写入的字节数（注意要判断fwrite的返回值，不要直接用write_len，避免写入失败计数错误）

关键代码片段参考 #

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

#define MAX_FILE_COUNT 7
#define MAX_FILE_SIZE (10 * 1024 * 1024) // 示例阈值10MB，可自行修改
#define FILE_NAME_PREFIX "app_log_"
#define FILE_NAME_SUFFIX ".dat"

// 滚动写入器结构体
typedef struct {
    FILE *cur_fp;
    int cur_idx;
    size_t cur_written;
} RotateFileWriter;

// 初始化写入器
int init_writer(RotateFileWriter *writer) {
    memset(writer, 0, sizeof(RotateFileWriter));
    // 简单实现默认从0开始，需要扫描历史文件的话可自行加stat逻辑遍历排序
    char filename[64] = {0};
    snprintf(filename, sizeof(filename), "%s%d%s", FILE_NAME_PREFIX, 0, FILE_NAME_SUFFIX);
    writer->cur_fp = fopen(filename, "wb");
    if (!writer->cur_fp) return -1;
    writer->cur_idx = 0;
    writer->cur_written = 0;
    return 0;
}

// 写入内容接口
int write_content(RotateFileWriter *writer, const void *data, size_t len) {
    if (!writer || !writer->cur_fp || !data || len == 0) return -1;

    // 判断是否需要滚动文件
    if (writer->cur_written + len > MAX_FILE_SIZE) {
        fclose(writer->cur_fp);
        // 计算下一个文件序号，取模实现循环
        writer->cur_idx = (writer->cur_idx + 1) % MAX_FILE_COUNT;
        char filename[64] = {0};
        snprintf(filename, sizeof(filename), "%s%d%s", FILE_NAME_PREFIX, writer->cur_idx, FILE_NAME_SUFFIX);
        // 截断模式打开，直接覆盖旧文件
        writer->cur_fp = fopen(filename, "wb");
        if (!writer->cur_fp) return -1;
        writer->cur_written = 0;
    }

    size_t written = fwrite(data, 1, len, writer->cur_fp);
    if (written != len) {
        // 写入异常处理逻辑可自行补充
        return -2;
    }
    writer->cur_written += written;
    // 建议加fflush，避免异常退出时内容丢失，根据性能要求选择是否开启
    // fflush(writer->cur_fp);
    return 0;
}

// 销毁写入器
void destroy_writer(RotateFileWriter *writer) {
    if (writer && writer->cur_fp) {
        fclose(writer->cur_fp);
        memset(writer, 0, sizeof(RotateFileWriter));
    }
}

优化建议 #

• 如果需要持久化当前写入状态，避免程序重启后找不到上次写入的位置，可以单独写一个小的状态文件，保存当前序号和已写字节数，启动时先读状态文件恢复
• 多线程环境下使用需要加互斥锁，避免同时写入/滚动文件出现竞态
• 对文件操作的返回值一定要做判断，避免磁盘满、权限不足等异常导致程序崩溃
• 如果需要保留文件修改时间作为滚动顺序的判断依据，可以用stat函数读取文件的st_mtime字段排序，找最旧的文件覆盖，不依赖序号也可以实现

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