C 语言实例 – 将字符串写入文件（手把手讲解）

C 语言实例 – 将字符串写入文件

在编程的世界里，数据的持久化存储是一个绕不开的话题。我们写的程序运行时，数据存在内存中，一旦程序结束，这些数据就消失了。但现实需求往往是：我们需要把一些信息保存下来，比如用户输入的记录、日志信息、配置参数等等。这时候，文件就成了数据的“仓库”。

C 语言作为一门底层、高效的编程语言，提供了强大的文件操作能力。今天我们就来深入一个非常实用的 C 语言实例：将字符串写入文件。这个操作看似简单，但却是构建完整程序的基础技能之一。无论你是初学者，还是已经有一定经验的中级开发者，掌握它都至关重要。

想象一下，你正在开发一个记事本程序。用户输入了一段文字，点击“保存”后，这段文字就要被写入到磁盘上的一个文件中。这个过程，本质上就是“将字符串写入文件”的典型应用场景。本篇文章将从零开始，带你一步步理解、实现这个功能。

文件操作的核心：FILE 指针

在 C 语言中，所有文件操作都围绕一个关键类型展开：FILE *。它是一个指向文件结构的指针，你可以把它理解为“通往文件的钥匙”。

当你打开一个文件时，系统会返回一个 FILE * 指针，后续所有的读写操作都会通过这个指针进行。就像你去图书馆借书，需要先办理借书卡（也就是 FILE *），然后才能从书架上取书或还书。

#include <stdio.h>

int main() {
    // 声明一个 FILE 指针，用于指向文件
    FILE *file_ptr;

    // 以写入模式打开文件 "output.txt"
    file_ptr = fopen("output.txt", "w");

    // 如果文件打开失败，fopen 返回 NULL
    if (file_ptr == NULL) {
        printf("文件打开失败！\n");
        return 1; // 程序退出，返回错误码
    }

    printf("文件打开成功，准备写入内容...\n");

    // 后续的写入操作将通过 file_ptr 进行
    // ...

    // 最后别忘了关闭文件
    fclose(file_ptr);

    return 0;
}

重点提醒：fopen 的第二个参数是打开模式，"w" 表示“写入模式”。如果文件不存在，会自动创建；如果存在，内容会被清空。如果你希望追加内容，应该使用 "a" 模式。

使用 fputs 写入字符串

有了文件指针，下一步就是写入数据。C 语言提供了多个函数来写入字符串，其中最常用的是 fputs。

fputs 的作用是将一个字符串写入文件，它不会自动添加换行符。这个函数非常直观，就像你用笔在纸上写字一样，你写什么，它就写什么。

#include <stdio.h>

int main() {
    FILE *file_ptr;

    // 以写入模式打开文件
    file_ptr = fopen("output.txt", "w");

    if (file_ptr == NULL) {
        printf("文件打开失败！\n");
        return 1;
    }

    // 要写入的字符串
    char text[] = "Hello, this is a test string written to file.";

    // 使用 fputs 将字符串写入文件
    // 注意：fputs 不会自动添加换行符
    fputs(text, file_ptr);

    printf("字符串已成功写入文件 output.txt\n");

    // 关闭文件
    fclose(file_ptr);

    return 0;
}

注释说明：

• fputs(text, file_ptr)：将 text 字符串写入 file_ptr 指向的文件。
• file_ptr 必须是有效的文件指针，否则程序会崩溃。
• fputs 只写入字符串本身，不包括末尾的 \0 结束符。

使用 fprintf 写入格式化字符串

如果你需要写入的内容包含变量，比如姓名、年龄、时间等，fputs 就不够用了。这时，fprintf 就派上用场了。

fprintf 的语法和 printf 非常相似，只是多了一个参数：文件指针。你可以把它理解为“把 printf 的输出目标从屏幕换成了文件”。

#include <stdio.h>

int main() {
    FILE *file_ptr;

    // 打开文件
    file_ptr = fopen("log.txt", "w");

    if (file_ptr == NULL) {
        printf("文件打开失败！\n");
        return 1;
    }

    // 定义变量
    char name[] = "张三";
    int age = 25;
    float score = 95.5;

    // 使用 fprintf 写入格式化字符串
    fprintf(file_ptr, "姓名：%s，年龄：%d，成绩：%.1f\n", name, age, score);

    printf("格式化字符串已写入 log.txt\n");

    // 关闭文件
    fclose(file_ptr);

    return 0;
}

注释说明：

• fprintf(file_ptr, ...)：将格式化后的字符串写入文件。
• 格式控制符如 %s、%d、%.1f 与 printf 完全一致。
• \n 会换行，确保每条记录独占一行，便于阅读。

多次写入与文件追加模式

有时候，我们需要往同一个文件中写入多条信息。例如，记录多个用户的日志。这时，"w" 模式就不合适了，因为它每次都会清空文件内容。

这时，我们使用 "a" 模式——“追加模式”。它会把新内容加在文件末尾，保留原有内容。

#include <stdio.h>

int main() {
    FILE *file_ptr;

    // 以追加模式打开文件
    file_ptr = fopen("history.txt", "a");

    if (file_ptr == NULL) {
        printf("文件打开失败！\n");
        return 1;
    }

    // 写入第一条记录
    fprintf(file_ptr, "2024-04-05 10:30:00 - 用户登录成功\n");

    // 写入第二条记录
    fprintf(file_ptr, "2024-04-05 10:35:20 - 用户提交表单\n");

    printf("多条记录已追加到 history.txt\n");

    fclose(file_ptr);

    return 0;
}

关键点：

• "a" 模式：打开文件后，文件指针自动定位到文件末尾。
• 适合日志、记录、缓存等场景。
• 如果文件不存在，会自动创建。

错误处理与最佳实践

在真实项目中，文件操作失败是常见情况。比如磁盘满了、权限不足、路径错误等。因此，始终检查 fopen 的返回值，是专业开发者的必备习惯。

// 推荐的文件操作模板
FILE *file_ptr = fopen("data.txt", "w");

if (file_ptr == NULL) {
    perror("文件打开失败"); // perror 会自动输出错误原因
    return 1;
}

// 写入操作...
fprintf(file_ptr, "数据写入成功\n");

// 无论是否成功，都要关闭文件
fclose(file_ptr);

perror 是一个很有用的函数，它会打印系统错误信息，比如“Permission denied”或“No such file or directory”。

实际案例：保存用户输入的日记

我们来做一个完整的 C 语言实例：让用户输入一段日记，然后保存到文件中。

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

int main() {
    FILE *file_ptr;
    char diary[256]; // 用于存储用户输入的日记内容

    // 打开日记文件（追加模式）
    file_ptr = fopen("diary.txt", "a");

    if (file_ptr == NULL) {
        printf("无法打开日记文件，请检查权限或路径。\n");
        return 1;
    }

    printf("请输入今天的日记内容（输入 'END' 结束）：\n");

    // 逐行读取用户输入
    while (1) {
        fgets(diary, sizeof(diary), stdin); // 读取一行

        // 检查是否输入了结束标志
        if (strcmp(diary, "END\n") == 0) {
            break;
        }

        // 将输入内容写入文件
        fputs(diary, file_ptr);
    }

    printf("日记已成功保存到 diary.txt\n");

    // 关闭文件
    fclose(file_ptr);

    return 0;
}

说明：

• fgets 用于读取一行字符串，比 gets 更安全（gets 已被废弃）。
• strcmp 用于比较字符串，判断是否输入了 "END"。
• 使用 "a" 模式，每次运行都追加新日记。

总结

通过本篇文章，我们系统地学习了 C 语言实例 – 将字符串写入文件 的完整流程。从文件指针的创建，到 fputs 和 fprintf 的使用，再到追加模式、错误处理和实际应用，每一步都环环相扣。

记住几个核心点：

• fopen 返回 FILE *，是所有文件操作的起点。
• fputs 适合写入固定字符串，fprintf 适合格式化输出。
• 使用 "w" 清空文件，"a" 追加内容。
• 每次打开文件后，务必检查是否成功，并在程序结束前 fclose。

这些技能不仅是写代码的工具，更是构建可靠、可维护程序的基础。当你下次需要保存数据时，不妨想一想：我已经掌握“将字符串写入文件”的方法了。