Skip to content

第 15 章:文件读写 ​

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

本章能学到什么 ​

  • 内存和磁盘的区别:为什么程序一关,变量就消失了
  • 用 open() 打开文件,用 with 保证文件被关好
  • 逐行读取文件,以及 "r" / "w" / "a" 三种模式
  • CSV 格式:用逗号分隔的成绩表,完整读写一遍
  • 文件不存在时会报什么错(为第 16 章铺垫)

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

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

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

python
score = 2500   # 程序一关,这个数就没了

差别在哪?变量住在内存里,内存一断电就清空;游戏能记住成绩,是因为它把成绩写进了磁盘上的文件。内存快而健忘,磁盘慢而持久——快是因为内存和 CPU 挨得近、走电信号;持久是因为磁盘上的数据不靠电维持。所以计算机的规矩一直是:正在算的放内存,要留的写磁盘。

很多游戏的存档就是一个普通文件,有的用记事本就能打开,里面一行一行写着关卡、血量、金币。游戏启动时把这些行读回内存,进度就"复活"了。

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

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

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

Python 用内置的 open() 打开文件,不需要任何 import:

python
# 第一步:写文件(存档)
with open("save.txt", "w", encoding="utf-8") as f:   # "w" 表示写模式
    f.write("level 3\n")
    f.write("score 2500\n")
# with 块一结束,文件自动关闭

# 第二步:读文件(读档)
with open("save.txt", "r", encoding="utf-8") as f:   # "r" 表示读模式
    for line in f:                   # 逐行读,读到末尾自动停下
        print(line, end="")          # 行末自带换行,end="" 避免重复换行

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

text
level 3
score 2500

几个细节:

细节说明
with ... as f打开文件并起名 f,缩进块结束就自动关文件
encoding="utf-8"指定中文编码,写中文时不会乱码
\n换行符;write() 不会自动换行,要自己写
end=""文件里每行末尾已有换行,print 就不用再补一个

为什么要用 with ​

不用 with 也能写文件:

python
f = open("save.txt", "w", encoding="utf-8")
f.write("level 3\n")
f.close()        # 忘了这行,数据可能卡在半路

问题在于:程序跑到一半出错,或者单纯忘了 close(),文件就没关好,写了一半的内容可能根本没落到磁盘上。with 把"用完必须关"变成了语法结构——缩进块一结束,无论正常走完还是中途出错,文件都会被关掉。这是 Python 的约定:操作文件,一律用 with。

逐行读取的三种写法 ​

for line in f: 每次从文件里取一整行放进 line,读到文件末尾自动停下。这不需要新语法,就是第 6 章的循环加第 9 章的字符串。

如果只想读一行,用 f.readline();想一次性把剩下的全读成一个列表,用 f.readlines():

写法读到什么适合
for line in f:一行一行地读最常用,大文件也不吃力
f.readline()只读一行,读到末尾返回空字符串只取表头
f.readlines()剩下所有行,装进一个列表文件小、想按下标翻行

一个常见的坑:读出来的每一行末尾都带着换行符 \n。直接 print(line) 会多空一行,所以前面用了 end="";要做字符串处理时,先用 line.strip() 去掉它。

覆盖、追加、读:三种模式 ​

open() 的第二个参数决定打开方式:

模式含义文件已存在时文件不存在时
"r"读正常打开报错 FileNotFoundError(本章末尾讲)
"w"覆盖写清空重来新建
"a"追加写接在末尾新建
python
with open("save.txt", "a", encoding="utf-8") as f:  # 追加模式
    f.write("score 3000\n")                          # 新成绩接在旧成绩后面

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

一个更像真存档的例子 ​

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

python
# 存档:三项数据,各占一行
with open("player.txt", "w", encoding="utf-8") as f:
    f.write("xiaoming\n")   # 名字
    f.write("3\n")          # 关卡
    f.write("2500\n")       # 分数

# 读档:按写入的顺序读回来
with open("player.txt", "r", encoding="utf-8") as f:
    name = f.readline().strip()
    level = f.readline().strip()
    score = f.readline().strip()

print("欢迎回来," + name)
print("第", level, "关,分数", int(score) + 100)
text
欢迎回来,xiaoming
第 3 关,分数 2600

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

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

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

各自做法:

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

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

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

int main() {
    ofstream fout("save.txt");   // 打开文件;没有就新建,有就清空
    fout << "level 3\n";
    fout << "score 2500\n";
    fout.close();                // 写完关闭

    ifstream fin("save.txt");
    string line;
    while (getline(fin, line)) { // 逐行读,读到末尾自动停下
        cout << line << endl;
    }
    fin.close();
    return 0;
}
text
level 3
score 2500

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

CSV:逗号分隔的表格 ​

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

一张成绩表长这样:

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

第一行是表头,下面每行一个学生的成绩。读 CSV 就是三步:读一行 → 按逗号切开 → 处理每一段。字符串的 split(",") 正好用来切逗号:

python
# 第一步:生成成绩表
with open("scores.csv", "w", encoding="utf-8") as f:
    f.write("name,math,chinese\n")
    f.write("xiaoming,95,88\n")
    f.write("xiaohong,87,91\n")

# 第二步:读出来,算每个人的总分
with open("scores.csv", "r", encoding="utf-8") as f:
    f.readline()                                   # 第一行是表头,先读掉
    for line in f:                                 # 逐行读
        name, math, chinese = line.strip().split(",")  # 去换行,按逗号切成三段
        total = int(math) + int(chinese)           # 字符串转成整数
        print(name, total)
text
xiaoming 183
xiaohong 178

strip() 去掉行末的换行符,split(",") 把一行切成三段,int() 把 "95" 变成整数 95——全是第 9 章字符串的老朋友。一行切成三段正好对应三个变量,Python 允许 name, math, chinese = ... 这样一次拆开。

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

文本文件与二进制文件 ​

本章写的都是文本文件:里面装的是人能读的字符,记事本打得开。还有一类二进制文件,里面装的是内存数据的原始字节,人看不懂,但读写更快、体积更小——照片、音乐、游戏的大存档都是二进制文件。在 open() 的模式后面加一个 b(如 "rb")就是二进制模式,入门阶段用不上,知道有这回事就行。

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

文件不存在会发生什么 ​

用 "r" 模式打开一个不存在的文件,Python 会直接报错,程序中断:

python
with open("no_such_file.txt", "r", encoding="utf-8") as f:
    print(f.readline())
text
Traceback (most recent call last):
  File "main.py", line 1, in <module>
FileNotFoundError: [Errno 2] No such file or directory: 'no_such_file.txt'

游戏第一次运行时还没有存档,就会撞上这个错误。怎么让程序"接住"它、而不是直接崩溃?那是第 16 章的异常机制要回答的问题。

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

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

python
# 先准备一篇文章
with open("article.txt", "w", encoding="utf-8") as f:
    f.write("the quick brown fox\n")
    f.write("jumps over the lazy dog\n")

# 再统计它
lines = 0
words = 0
with open("article.txt", "r", encoding="utf-8") as f:
    for line in f:
        lines += 1
        words += len(line.split())   # split() 按空白切成词
print("lines:", lines)
print("words:", words)
text
lines: 2
words: 9

split() 不写参数时按任意空白(空格、换行)切分,正好一个词一段。这个例子的骨架——打开、逐行、切分、计数——正是很多文本处理程序共同的骨架;第 18 章的 collections 模块还会给这个骨架装上更顺手的工具。

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

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

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

这又一次回答了"为什么要用 with":它不仅省事,还保证数据不丢。

常见坑 ​

坑现象办法
忘写 encoding="utf-8"中文变成乱码打开文件时随手写上
write() 不换行所有内容挤在一行行末自己加 \n
读出的行带 \n打印多空一行,比较多出一个字符先 strip() 再处理
路径写错FileNotFoundError先确认程序运行的目录

小结 ​

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

动手实验 ​

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

第 1 题:

python
with open("seven.txt", "w", encoding="utf-8") as f:
    for i in range(1, 10):
        f.write(f"7x{i}={7 * i}\n")

with open("seven.txt", "r", encoding="utf-8") as f:
    for line in f:
        print(line, end="")
text
7x1=7
7x2=14
7x3=21
7x4=28
7x5=35
7x6=42
7x7=49
7x8=56
7x9=63
💡 查看答案

第 2 题:把打开方式改成 open("seven.txt", "a", encoding="utf-8"),循环里写 f.write(f"8x{i}={8 * i}\n")。运行后用记事本打开 seven.txt,能看到 8 的口诀接在 7 的口诀后面;如果还用 "w",旧内容就被清空了。

💡 查看答案

第 3 题:

python
with open("scores.csv", "w", encoding="utf-8") as f:
    f.write("name,math,chinese,english\n")
    f.write("xiaoming,95,88,92\n")
    f.write("xiaohong,87,91,85\n")

with open("scores.csv", "r", encoding="utf-8") as f:
    f.readline()       # 表头
    for line in f:
        name, math, chinese, english = line.strip().split(",")
        total = int(math) + int(chinese) + int(english)
        print(name, total)
text
xiaoming 275
xiaohong 263