Skip to content

第 15 章:文件读写 ​

本章承接第 1 章的变量与第 10 章的容器:此前的所有数据都住在内存里,程序一关就消失;本章第一次把数据送到磁盘上。用到的全是旧知识——字符串(第 9 章)、循环(第 6 章)、头文件(第 4 章)。

本章能学到什么 ​

  • 内存和磁盘的区别:为什么程序一关,变量就消失了
  • 用 ofstream 把数据写进文件,用 ifstream 把数据读回来
  • 逐行读取与按词读取,以及覆盖、追加两种写模式
  • CSV 格式:用逗号分隔的成绩表,完整读写一遍
  • 文件不存在时会发生什么(为第 16 章铺垫)

场景:关掉游戏,成绩还在吗 ​

打了一个下午的闯关游戏,关掉电脑,明天再打开——积分还在,关卡还在。

再看看我们自己写的程序:

cpp
int score = 2500;   // 程序一关,这个数就没了

差别在哪?变量住在内存里,内存一断电就清空;游戏能记住成绩,是因为它把成绩写进了磁盘上的文件。很多游戏的存档就是一个普通文件,有的用记事本就能打开,里面一行一行写着关卡、血量、金币。游戏启动时把这些行读回内存,进度就"复活"了。

用学校里的东西打比方:内存像课堂上的草稿纸,算得快,下课就扔;文件像交上去的作业本,老师收走了,明天还能发回来。本章学会两件事:把内存里的数据写进文件(存档),把文件里的数据读回内存(读档)。

对比内存(变量)磁盘(文件)
速度快慢
断电后清空保留
像什么草稿纸作业本
第几章学的第 1 章起本章

文件读写三步走 ​

用 cout 写屏幕、用 cin 读键盘,走的是"流"(第 3 章)。文件读写也是流,只是把流的方向从屏幕和键盘换成了磁盘文件。

步骤屏幕键盘版文件版
打开不用开,程序自带用 ofstream / ifstream 打开
读写cout << / cin >>fout << / getline(fin, ...)
关闭不用关调用 .close()

文件流住在头文件 <fstream> 里,别忘了 #include(第 4 章讲过包含)。

写文件与读文件:一个完整例子 ​

cpp
#include <iostream>
#include <fstream>      // 文件流的头文件
#include <string>
using namespace std;

int main() {
    // 第一步:写文件(存档)
    ofstream fout("save.txt");   // 打开文件;没有就新建,有就清空
    fout << "level 3\n";         // 用法和 cout 一模一样
    fout << "score 2500\n";
    fout.close();                // 写完关闭,数据才真正落盘

    // 第二步:读文件(读档)
    ifstream fin("save.txt");    // 打开同一个文件,准备读
    string line;
    while (getline(fin, line)) { // 逐行读,读到末尾自动停下
        cout << line << endl;
    }
    fin.close();
    return 0;
}

运行后,程序所在目录里多出一个 save.txt,屏幕上打印:

text
level 3
score 2500

几个细节:

细节说明
fout 的用法和 cout 完全一样,<< 照样用,只是内容进了文件
文件在哪里建在程序运行的目录里,用记事本就能打开看
close() 的作用像盖上笔帽;不写程序也能跑,但写了更保险,数据不会卡在半路

逐行读取与按词读取 ​

getline(fin, line) 每次从文件里读一整行,放进字符串 line。读到一行就返回真,读到文件末尾就返回假,所以可以直接放进 while 的条件里:还能读到一行,就继续循环。这不需要新语法,就是第 6 章的循环加第 9 章的字符串。

如果文件里存的是数字,fin >> 也能像 cin >> 一样直接读:

cpp
ifstream fin("numbers.txt");   // 文件里每行一个数:10 20 30
int x;
while (fin >> x) {             // 还能读到一个数,就继续
    cout << x * 2 << endl;     // 打印 20 40 60
}
fin.close();
读法读到什么适合
getline(fin, line)一整行(含空格)读文本、读 CSV
fin >> x一个"词"(遇空格、换行就停)读数字、读单词

一个常见的坑:混用 fin >> x 和 getline。>> 读完一个数后,换行符还留在原地,紧跟其后的 getline 会读到一行空行。避开办法很简单:同一个文件里只用一种读法。

覆盖还是追加 ​

用 ofstream 打开一个已经存在的文件,默认会把旧内容清空重写。想接在旧内容后面写,要加第二个参数 ios::app(append,追加):

写法模式文件已存在时文件不存在时
ofstream fout("a.txt")覆盖写清空重来新建
ofstream fout("a.txt", ios::app)追加写接在末尾新建
ifstream fin("a.txt")读正常打开打开失败(本章末尾讲)
cpp
ofstream fout("save.txt", ios::app);  // 追加模式
fout << "score 3000\n";               // 新成绩接在旧成绩后面
fout.close();

什么时候用哪种?游戏存档用覆盖——只保留最新进度;比赛成绩榜用追加——每一次成绩都留下来。

一个更像真存档的例子 ​

真实的存档不止一行。把玩家的名字、关卡、分数存成"一项一行",读回来逐项解析:

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

int main() {
    // 存档:三项数据,各占一行
    ofstream fout("player.txt");
    fout << "xiaoming\n";   // 名字
    fout << "3\n";          // 关卡
    fout << "2500\n";       // 分数
    fout.close();

    // 读档:按写入的顺序读回来
    ifstream fin("player.txt");
    string name, level, score;
    getline(fin, name);
    getline(fin, level);
    getline(fin, score);
    fin.close();

    cout << "欢迎回来," << name << endl;
    cout << "第 " << level << " 关,分数 " << stoi(score) + 100 << endl;
    return 0;
}
text
欢迎回来,xiaoming
第 3 关,分数 2600

注意文件里存的全部是文本——数字 2500 写进去变成 "2500" 这三个字符,读回来要用 stoi 转回整数才能做加法。这是文件和内存的一道分界线:过这条线,一切都要变成文本;过回来,再变回数字。

【跨语言对照】fstream 与 open/with ​

本质问题:两种语言要回答同一个问题——怎么把内存里的数据安全地搬进磁盘文件,搬完之后又怎么保证文件被关好。

各自做法:

动作C++Python
打开文件准备写ofstream fout("a.txt")f = open("a.txt", "w")
打开文件准备读ifstream fin("a.txt")f = open("a.txt", "r")
写一行fout << "hi\n"f.write("hi\n")
读一行getline(fin, line)f.readline()
关闭fout.close()f.close(),或交给 with 自动关

同一件事的两段代码,输出完全一致。C++ 版就是本章前面的完整例子;Python 版(详见《Python 从入门到精通》第 15 章):

python
# 写文件:with 块结束时会自动关闭文件
with open("save.txt", "w", encoding="utf-8") as f:
    f.write("level 3\n")
    f.write("score 2500\n")

# 读文件:逐行读,读到末尾自动停下
with open("save.txt", "r", encoding="utf-8") as f:
    for line in f:
        print(line, end="")   # 行末自带换行,end="" 避免重复换行
text
level 3
score 2500

为什么设计不一样:C++ 把文件看成一个流对象,打开后归程序员管,用完手动 close()(第 17 章会讲更省心的 RAII 思路)。Python 的 with 把"用完必须关"写进了语法结构——with 块一结束,文件自动关闭。两种设计都在回答"文件谁来关",一个把责任交给人,一个把责任交给语法。

CSV:逗号分隔的表格 ​

CSV(Comma-Separated Values,逗号分隔值)是最简单的表格文件:一行一条记录,逗号分开每一列。它流行的原因很朴素:人能用记事本读,Excel 能直接打开,任何编程语言都容易处理。缺点是如果数据本身带逗号,就要额外的规则来区分,本章的例子先避开这种情况。

一张成绩表长这样:

text
name,math,chinese
xiaoming,95,88
xiaohong,87,91

第一行是表头,下面每行一个学生的成绩。读 CSV 就是三步:读一行 → 按逗号切开 → 处理每一段。istringstream 可以把一个字符串当成小文件来读,正好用来切逗号:

cpp
#include <iostream>
#include <fstream>
#include <sstream>     // istringstream 的头文件
#include <string>
using namespace std;

int main() {
    // 第一步:生成成绩表
    ofstream fout("scores.csv");
    fout << "name,math,chinese\n";
    fout << "xiaoming,95,88\n";
    fout << "xiaohong,87,91\n";
    fout.close();

    // 第二步:读出来,算每个人的总分
    ifstream fin("scores.csv");
    string line;
    getline(fin, line);                 // 第一行是表头,先读掉
    while (getline(fin, line)) {
        istringstream ss(line);         // 把这一行当成小文件
        string name, math, chinese;
        getline(ss, name, ',');         // 第三个参数:按逗号切
        getline(ss, math, ',');
        getline(ss, chinese, ',');
        int total = stoi(math) + stoi(chinese);  // 字符串转成整数
        cout << name << " " << total << endl;
    }
    fin.close();
    return 0;
}
text
xiaoming 183
xiaohong 178

stoi 把 "95" 这样的字符串变成整数 95,是第 9 章字符串的延伸用法。getline 的第三个参数是分隔符:不写就按行切,写 ',' 就按逗号切。

Python 册里有一个一模一样的程序,连输出都相同,可以去《Python 从入门到精通》第 15 章对照着看。

文本文件与二进制文件 ​

本章写的都是文本文件:里面装的是人能读的字符,记事本打得开。还有一类二进制文件,里面装的是内存数据的原始字节,人看不懂,但读写更快、体积更小——照片、音乐、游戏的大存档都是二进制文件。

对比文本文件二进制文件
内容字符,人能读字节,只有程序能读
例子save.txt、scores.csv照片 .jpg、音乐 .mp3
本章例子全部不涉及

入门阶段用文本文件足够:能打开看,错了好查。

文件不存在会发生什么 ​

用 ifstream 打开一个不存在的文件,程序不会崩溃,只是打开失败:

cpp
ifstream fin("no_such_file.txt");
if (!fin.is_open()) {
    cout << "存档不存在,从第一关开始" << endl;
} else {
    // 正常读档
}

is_open() 返回假,说明文件没打开成功。游戏第一次运行时还没有存档,走的就是这条路。

这只是"自己检查"的办法。如果错误发生在更深的地方,检查不到怎么办?比如读文件读到一半磁盘满了,比如别人写的函数内部出了错。那是第 16 章的异常机制要回答的问题。

实战:统计一篇文章的行数和词数 ​

把本章的工具串起来做一件真事:统计一个文本文件有几行、几个词。

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

int main() {
    // 先准备一篇文章
    ofstream fout("article.txt");
    fout << "the quick brown fox\n";
    fout << "jumps over the lazy dog\n";
    fout.close();

    // 再统计它
    ifstream fin("article.txt");
    string line;
    int lines = 0, words = 0;
    while (getline(fin, line)) {
        lines++;
        words++;                      // 每行先算上第一个词
        for (char c : line) {         // 第 9 章的逐字符遍历
            if (c == ' ') words++;    // 每个空格后面是一个新词
        }
    }
    fin.close();
    cout << "lines: " << lines << endl;
    cout << "words: " << words << endl;
    return 0;
}
text
lines: 2
words: 9

数词的办法很朴素:一句话里,空格数加一约等于词数。真正的分词比这复杂得多,但对规整的英文文本够用了。这个例子的骨架——打开、逐行、逐字符、计数——正是很多文本处理程序共同的骨架。

写进去的数据什么时候真正落盘 ​

fout << 写的内容并不总是立刻进磁盘。为了速度,写操作先进入一个临时的小篮子(缓冲区),攒够一拨再统一送往磁盘——就像值日生攒够一筐废纸再一起倒。close() 做的最重要的事,就是把篮子里剩下的数据全部倒干净再关门。

情况篮子里的数据
正常 close()全部落盘
程序正常结束多数情况下也会落盘,但不该赌
程序中途崩溃可能丢失

所以"写完随手 close()"不是洁癖,是保证数据不丢的保险。

常见坑 ​

坑现象办法
忘记 close()程序结束时文件内容不全写完随手关,养成习惯
混用 >> 和 getlinegetline 读到空行同一个文件只用一种读法
路径写错文件"找不到",程序目录里却没有新文件先确认程序运行的目录
覆盖当追加用旧成绩被清空想清楚用哪种模式再打开

小结 ​

变量住内存,文件住磁盘;断电之后,只有文件还记得。ofstream 写、ifstream 读、getline 逐行、逗号切 CSV——这四样工具足够做出真正的存档系统。过文件这道线时数字要变成文本、读回来再变回数字,是本章最隐蔽也最重要的一条规矩。第 19 章的综合项目会让本章的本领取代"程序一关成绩清零"的日子。

动手实验 ​

  1. 写一个程序:把乘法口诀表里 7 的那一行(7×1 到 7×9)写进 seven.txt,再读出来打印到屏幕上。
  2. 在上题基础上改用追加模式,把 8 的口诀接在同一个文件后面,用记事本打开观察文件内容。
  3. 改造 CSV 示例:成绩表加一列英语成绩,输出每个人的三科总分。
💡 查看答案

第 1 题:

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

int main() {
    ofstream fout("seven.txt");
    for (int i = 1; i <= 9; i++) {
        fout << "7x" << i << "=" << 7 * i << "\n";
    }
    fout.close();

    ifstream fin("seven.txt");
    string line;
    while (getline(fin, line)) {
        cout << line << endl;
    }
    fin.close();
    return 0;
}
text
7x1=7
7x2=14
7x3=21
7x4=28
7x5=35
7x6=42
7x7=49
7x8=56
7x9=63
💡 查看答案

第 2 题:把打开方式改成 ofstream fout("seven.txt", ios::app);,循环里写 "8x" << i << "=" << 8 * i。运行后用记事本打开 seven.txt,能看到 8 的口诀接在 7 的口诀后面;如果忘了加 ios::app,旧内容就被清空了。

💡 查看答案

第 3 题:

cpp
#include <iostream>
#include <fstream>
#include <sstream>
#include <string>
using namespace std;

int main() {
    ofstream fout("scores.csv");
    fout << "name,math,chinese,english\n";
    fout << "xiaoming,95,88,92\n";
    fout << "xiaohong,87,91,85\n";
    fout.close();

    ifstream fin("scores.csv");
    string line;
    getline(fin, line);   // 表头
    while (getline(fin, line)) {
        istringstream ss(line);
        string name, math, chinese, english;
        getline(ss, name, ',');
        getline(ss, math, ',');
        getline(ss, chinese, ',');
        getline(ss, english, ',');
        int total = stoi(math) + stoi(chinese) + stoi(english);
        cout << name << " " << total << endl;
    }
    fin.close();
    return 0;
}
text
xiaoming 275
xiaohong 263