一、本章知识地图

二、必须记住的十个结论

1. 文件只是一条流 ——ifstream 是 istream 的子类、ofstream 是 ostream 的子类，所以 << >> 原样可用；"写给屏幕"和"写给文件"能共用同一个函数（参数写 ostream &）。
2. 打开之后必须检查 ——if (!in) { ... }。失败不报错、不崩溃，只是"流变成假的" ——后面所有读写全部无效，程序照样跑下去。
3. ofstream 的默认打开会清空文件 ——因为它的默认模式是 ios::out | ios::trunc。想接着写必须显式 ios::app。 这是本章第一号"数据不见了"事故。
4. fstream 的默认模式不创建文件 ——默认是 ios::in | ios::out，含 in 就要求文件已存在。要"不存在就建"，可以先用 ofstream + app 温和地"碰"一下。
5. 写完就 close() ——close() 会把缓冲区刷进磁盘。"写完立刻读读不到"、"写完别的程序看不到"，十有八九是没关（或没刷）。
6. 两条路按"谁来读"选 ——给人看 / 要跨平台 / 要能手工改 → 文本；只给程序读 / 要快、要小 → 二进制。
7. 二进制必须加 ios::binary，而且有四个前提 ——① 不能有指针成员；② 不能用 string/vector 成员（换成定长数组）；③ 注意对齐填充（sizeof 比成员相加大）；④ 字节序和类型长度依平台 ——所以只适合"自己写自己读"。
8. 读文件永远用"读操作当条件" ——while (getline(in, line)) / while (in >> x) / while (in.read(...))。绝不要写 while (!in.eof())（它会多处理一次）。
9. eof() 是"事后报告" ——它表示"上一次读碰到了末尾"，不是"下一次会碰到末尾"。正确用法是循环结束后判断"是正常读完、还是格式错了"；要"事前预判"用 peek()。
10. 随机访问＝定长记录 ＋ 偏移计算 ——第 i 条的偏移 = i × sizeof(记录)；"读-改-写"时读位置和写位置要分别 seek（seekg 之后还要 seekp）。

三、动手 Demo：两关自测

第一关（写代码）：一个"学生成绩文件管理系统"

要求：只用本章（＋前面课程）的东西，做一个能反复运行、数据能留下来的小系统。

参考实现（自己先写，写不出来再看）：

#include <iostream>
#include <fstream>
#include <string>
#include <cstdio>
using namespace std;

struct Rec { int id; char name[16]; double score; };

const string DB = "students.dat";

bool fileExists(const string &f) {
    ifstream in(f);
    return (bool)in;
}

// 初始化：只建一次，之后不再覆盖
void initDB() {
    if (fileExists(DB)) { cout << "-- 数据库已存在，保留原数据 --" << endl; return; }
    Rec recs[3] = { {1, "Ada", 60.0}, {2, "Bob", 70.0}, {3, "Cid", 80.0} };
    ofstream o(DB, ios::binary);
    if (!o) { cerr << "建库失败" << endl; return; }
    o.write((char *)recs, sizeof(recs));
    o.close();
    cout << "-- 已初始化 3 条记录 --" << endl;
}

// 全部列出 + 统计
void listAll() {
    ifstream in(DB, ios::binary);
    if (!in) { cerr << "打不开数据库" << endl; return; }
    Rec r;
    int n = 0; double sum = 0;
    cout << "-- 全部记录 --" << endl;
    while (in.read((char *)&r, sizeof(r))) {
        cout << "   id=" << r.id << " name=" << r.name << " score=" << r.score << endl;
        sum += r.score; n++;
    }
    if (n) cout << "   共 " << n << " 条，平均 " << sum / n << endl;
    in.close();
}

// 追加一条
void append(const Rec &r) {
    ofstream o(DB, ios::binary | ios::app);
    if (!o) { cerr << "追加失败" << endl; return; }
    o.write((char *)&r, sizeof(r));
    o.close();
    cout << "-- 已追加 " << r.name << " --" << endl;
}

// 按"第 i 条（从 0 开始）"修改分数
void modify(int i, double newScore) {
    fstream f(DB, ios::in | ios::out | ios::binary);
    if (!f) { cerr << "打不开数据库" << endl; return; }
    long long pos = (long long)i * sizeof(Rec);
    Rec r;
    f.seekg(pos, ios::beg);
    if (!f.read((char *)&r, sizeof(r))) { cout << "-- 第 " << i << " 条不存在 --" << endl; f.close(); return; }
    r.score = newScore;
    f.seekp(pos, ios::beg);              // ★ 写位置要单独定位
    f.write((char *)&r, sizeof(r));
    f.close();
    cout << "-- 已把第 " << i << " 条（" << r.name << "）改成 " << newScore << " --" << endl;
}

int main() {
    cout << "记录大小 = " << sizeof(Rec) << " 字节" << endl;
    initDB();
    listAll();

    Rec nr = {4, "Dee", 90.0};
    append(nr);

    modify(1, 100.0);                    // 把第 2 条（Bob）改成 100
    listAll();
    return 0;
}

看到什么算成功（第一次运行）：

记录大小 = 32 字节
-- 已初始化 3 条记录 --
-- 全部记录 --
   id=1 name=Ada score=60
   id=2 name=Bob score=70
   id=3 name=Cid score=80
   共 3 条，平均 70
-- 已追加 Dee --
-- 已把第 1 条（Bob）改成 100 --
-- 全部记录 --
   id=1 name=Ada score=60
   id=2 name=Bob score=100
   id=3 name=Cid score=80
   id=4 name=Dee score=90
   共 4 条，平均 82.5

数字怎么来的：

• 平均 70 = (60 + 70 + 80) / 3 = 210 / 3；
• 平均 82.5 = (60 + 100 + 80 + 90) / 4 = 330 / 4。

第二次运行（数据已经在）：

记录大小 = 32 字节
-- 数据库已存在，保留原数据 --
-- 全部记录 --
   id=1 name=Ada score=60
   id=2 name=Bob score=100
   id=3 name=Cid score=80
   id=4 name=Dee score=90
   共 4 条，平均 82.5
-- 已追加 Dee --
...

这就是"数据活过了程序" ——第一次运行的结果（Bob 改成了 100），第二次运行还在。

四道顺手的练习题：

1. 把 write 后面的 ios::binary 删掉 → 在这个数据上可能看不出差别（没有 \n 字节）——但把 name 填成含换行的字符串再试，就会看到字节数变了。永远别省 binary。
2. 把 char name[16] 改成 string name → 程序多半直接崩（15.3.4 的老雷）。
3. 把 modify 里的 seekp 删掉 → 看 Ada 那条被 Bob 的数据覆盖（这是 15.4.4 的教训，证明两个位置是分开的）。
4. 加一个"删除最后一条"的功能 → 思路：① 读出全部记录；② 用 ios::trunc 重写（少写一条）；或者用 C++17 的 fs::resize_file 截短（二进制定长记录才能这么做）。

第二关（找错）：十五个判断，逐个说明对错与原因

30 秒实验：把 ① ② ⑤ ⑦ ⑧ ⑩ ⑪ 逐个敲一遍。特别看 ① 和 ⑪：一个让你丢数据、一个让你删不掉文件，都是"看起来没错"的代码。 重点看 ②⑦：它们"不报错、安静地错" ——这类错误才是真正花时间的。

四、常见误区（本章汇总）

1. "文件打不开，程序会提醒我" ——不会。标准库选择"安静失败"（点灯不喊人）。必须自己写 if (!in)。
2. "ofstream 只是打开来写，不会动旧内容" ——默认会清空（含 trunc）。这一条造成的数据损失比本章其他所有坑加起来还多。
3. "endl 和 "\n" 一样，随便用" ——endl 每次都要刷盘。批量写数据用 "\n"，要实时可见（日志）才用 endl。
4. "读完文件想再读一遍，seekg(0) 就行" ——不行，还要先 clear()（读到末尾置了 failbit，失败的流不理会 seekg）。
5. "二进制文件比文本文件高级" ——它们只是不同的工具：二进制快、小，但不跨平台、不能手工改、扛不住结构变化；文本慢一点，但能读、能改、能跨工具。选工具看需求，不看"高级"。
6. "结构体可以直接写文件" ——只有在"无指针、无 string、同编译器、同平台"的前提下才行。否则你写下的是一堆"只在这一次运行里有效的字节"。
7. "eof() 为真说明出错了" ——"读完"是正常结束，不是错误（只是 fail() 会跟着亮）。eof() 的正确用途是"事后归因"。
8. "文件操作就是语法，记住函数名就行" ——恰恰相反：文件操作 90% 的难点在"状态判断"和"模式选择"上，不在函数名上。 本章所有重要结论，几乎都是"某件事不按你以为的方式发生"：默认会清空、失败不报错、读完会置错、数据留在缓冲里、删除要文件没被占用。

五、写完这一章，你会什么了

这一章之后，你的程序"记得住事了"：

• 能写文件、能读回来、能验证内容对得上（15.3.1）；
• 知道什么时候用文本、什么时候用二进制（15.3）；
• 能写出一个"数据能活过下一次运行"的小系统（本节第一关）；
• 能写一个真正的命令行工具（15.3.5 的文件复制 + 7.8.3 的 argv）；
• 能直接跳到文件里第 N 条记录去读、去改（15.4.4，这就是数据库的底层）；
• 知道"追加"和"覆盖"差在哪一个常量上（15.4.2）；
• 能一眼看出"这个循环会多跑一轮"（15.4.3）；
• 知道"文件被占用就删不掉"是为什么（15.6）。

同时拿到三张能一直用的"判断表"：

• ☑ 第十六章 坦克动荡游戏 —— 已完结：本章总结（游戏项目：窗口 ＋ 游戏循环 ＋ GDI+ ＋ 对象体系；带走了游戏循环、对象分工、状态管理三个思路）

相关笔记

• 流简介 —— 本章起点：文件只是一条流
• 文件的打开 —— 打开与检查（本章的分水岭）
• 文件的读-写 —— 文本与二进制两条路
• 二进制文件的读-写（结构体四前提） —— 最容易踩雷的一节
• 文件错误与状态 —— 四盏灯与 clear()
• 文件结尾的判断 —— eof() 的正解
• 在指定位置读-写文件 —— 随机访问（数据库雏形）
• 删除文件 —— remove 与 C++17 <filesystem>
• 小结 —— 上一章知识地图
• 开发背景 —— 下一章起点：把学过的全用一遍
• 本章总结 —— 下一章知识地图 ＋ 全书收官
• 🔷 C++基础 · 索引 —— 全课路线图