第 19 章 和硬盘说悄悄话:文件读写
📖 本章目标:学会读写文件,掌握 with 语句和编码。
学完本章,你的程序就能"记住"数据了——关了电脑再打开,它还记得昨天的事。
到目前为止,你的程序都活在"内存"这个临时世界里:一关程序,数据烟消云散。本章是转折点——学会读写文件后,你的程序将拥有"长期记忆"。
【开场小剧场】程序的记忆
学生: 皮皮,我发现一个严重的问题:我的程序一关,数据就没了,白干!
皮皮: 因为程序默认只在内存里干活,内存一断电就清空。想让数据"活到明天",必须写进硬盘上的文件。
学生: 就像我写日记?
皮皮: 对!今天学的就是:让程序把数据写进文件(写日记),和把数据从文件读回来(翻日记)。从此你的程序就拥有"长期记忆"了。
学生: 那万一我写日记写一半,程序崩了呢?
皮皮: (拍手)问得好!所以一会儿教你 with——它保证不管出不出事,日记本都给你合上。先别急,一步一步来。
19.1 写入文件:open + write
把东西写进文件,三步:打开 → 写入 → 关闭。
f = open("diary.txt", "w", encoding="utf-8") # ① 打开(写模式)
f.write("2026年8月10日 晴\n") # ② 写入
f.write("今天学会了文件读写!\n")
f.close() # ③ 关闭
逐项解释:
open("diary.txt", "w"):打开文件。"w"是模式(见下表);f.write(...):写入内容。注意\n要自己写,Python 不会自动换行;f.close():关闭文件。很重要,不关会占着文件,还可能丢失数据。
运行后,当前目录下会出现一个 diary.txt 文件,里面躺着两行文字。这就是你的程序第一次在硬盘上留下"日记"。
逐行拆解:
- open(...):向 Python"申请"打开这个文件,返回一个"文件句柄" f(可以理解为跟这个文件连上的"电话线");
- f.write("..."):通过 f 这条电话线,把内容传进文件;
- f.close():挂断电话线。不挂断的后果:文件被占用,别的程序打不开,而且写的内容可能没真正落盘。
打开模式:
| 模式 | 含义 | 不存在时 |
|---|---|---|
"w" |
写入(清空原有内容) | 自动创建 |
"r" |
读取 | 报错 FileNotFoundError |
"a" |
追加(在末尾继续写) | 自动创建 |
⚠️
"w"会先清空文件再写! 如果文件里本来有内容,一open("w")就全没了。想保留,用"a"追加。
换例加深:写多行内容
with open("note.txt", "w", encoding="utf-8") as f:
f.write("第一行\n")
f.write("第二行\n")
易错提醒: 别漏 \n。write 不会自动换行,漏了 \n,两行文字会挤成一团。
配套代码文件:code/ch19/diary.py。
19.2 读取文件:read 全家桶
读文件也是三步:打开 → 读取 → 关闭。
f = open("diary.txt", "r", encoding="utf-8")
content = f.read() # 一次性读完所有内容
f.close()
print(content)
read() 会返回整个文件内容(一个字符串)。除了它,还有 readline()(读一行)和 readlines()(读所有行成列表):
f = open("diary.txt", "r", encoding="utf-8")
line1 = f.readline() # 读第一行(注意:会带上换行符)
line2 = f.readline() # 再读下一行
f.close()
print(line1, line2)
逐行拆解:
- f.readline():每调用一次,读一行;
- 第二次调用 readline():接着读下一行(它记得自己读到哪了);
- f.close():读完关闭。
换例加深:readlines 一次拿全部行
with open("diary.txt", "r", encoding="utf-8") as f:
lines = f.readlines() # 返回一个列表,每个元素是一行
print(lines)
输出类似 ['第一行\n', '第二行\n']。注意每个元素末尾都带着 \n。
🐍"皮皮注:
readline读到的行带末尾的换行符\n,所以打印时经常要用strip()把\n和空格清掉(第 5 章学过)。"
易错提醒: 读不存在的文件会 FileNotFoundError(见翻车现场坑 1)。读文件前想清楚:这个文件保证存在吗? 不确定就做好兜底。
19.3 with 语句:自动关门
f.close() 老忘写怎么办?Python 提供了 with 语句,代码块结束自动关闭,再也不怕忘了:
with open("diary.txt", "w", encoding="utf-8") as f:
f.write("用了 with,不怕忘关!\n")
# 到这里,文件已自动关闭
with open("diary.txt", "r", encoding="utf-8") as f:
content = f.read()
print(content)
逐行拆解:
- with open(...) as f::"以 f 的名义打开这个文件";
- 缩进块里:f.write(...) 或 f.read(),随便用;
- 缩进块结束:不管正常结束还是中途报错,with 都会自动调用 close() 关文件。
语法格式:
with open(文件名, 模式, encoding="utf-8") as 变量名:
用变量名操作文件
读法:"以 f 的名义打开这个文件,处理完这一块,自动关闭。"
换例加深:with 里报错也会自动关
try:
with open("a.txt", "r", encoding="utf-8") as f:
content = f.read()
except FileNotFoundError:
print("文件不存在") # 即便中途出错,文件也会被 with 关掉
皮皮的建议:以后写文件操作,一律用 with。 少一个坑,多一分安心。
易错提醒: with 里的文件变量 f 只在 with 块内有效。块结束后再 f.read(),会得到"文件已关闭"的错误(ValueError)。
19.4 追加模式:接着写,不清空
想给文件"续写",用 "a"(append,追加):
with open("diary.txt", "a", encoding="utf-8") as f:
f.write("追加了一行:明天继续加油!\n")
"a" 不会清空原文件,只把内容加在末尾。适合做日志、做记录。
对比三种模式的"续写效果":
"w"再打开一次:原内容全没了,从空文件开始写;"a"再打开一次:原内容保留,新内容接在末尾;"r"打开:不能写,只能读。
换例加深:模拟一个"记流水账"的小程序
with open("log.txt", "a", encoding="utf-8") as f:
f.write("10:00 开始学习\n")
with open("log.txt", "a", encoding="utf-8") as f:
f.write("11:00 休息一下\n")
with open("log.txt", "r", encoding="utf-8") as f:
print(f.read())
两条日志都被保留——这就是 "a" 的威力:多次运行,内容越攒越多。
💡 日志类、记录类的数据,天然适合
"a"追加。写程序时想想:"这次运行要覆盖上一次,还是接着上一次?"——想清楚了再选模式。
19.5 编码:乱码的元凶
读文件时如果看到一堆乱码 ����,十有八九是编码不对。
编码(encoding)就是"文字 ↔ 数字"的翻译规则。中文最常用的编码:
- UTF-8:现代默认,中文英文通吃;
- GBK:老 Windows 系统常用,只懂简体中文为主。
为什么乱码? 写入时用的 UTF-8,读取时忘了指定,系统可能用了别的编码"瞎翻译"。好比日记用中文写的,你却用英文语法去读——当然看不懂。
皮皮的铁律:
# 读写含中文的文件,一律显式指定 encoding="utf-8"
with open("diary.txt", "w", encoding="utf-8") as f:
f.write("中文没问题")
with open("diary.txt", "r", encoding="utf-8") as f:
print(f.read())
不写 encoding,Python 在不同系统上可能默认不同,乱码风险极高。主动指定,一劳永逸。
换例加深:写一个"中英混合"文件再读回来
with open("mixed.txt", "w", encoding="utf-8") as f:
f.write("Hello 世界!\n")
with open("mixed.txt", "r", encoding="utf-8") as f:
print(f.read()) # Hello 世界!
易错提醒: 如果别人给你的文件是 GBK 编码的(比如老系统生成的),用 encoding="utf-8" 读还是会乱码或报 UnicodeDecodeError。这时候把参数换成 encoding="gbk" 试试。编码要"读写一致"。
19.6 逐行读取:大文件的正确姿势
如果文件特别大(比如几 GB 的日志),read() 一次性全读进内存,可能直接挤爆内存。正确姿势:逐行读取:
with open("diary.txt", "r", encoding="utf-8") as f:
for line in f: # 一行一行来,边读边处理
print(line.strip()) # strip 去掉换行符
逐行拆解:
- for line in f:f 本身就可以被 for 遍历——每次迭代取一行;
- print(line.strip()):strip() 去掉行尾的 \n(不然打印会多空行)。
for line in f 会每次只读一行到内存,处理完就丢掉,内存占用几乎为零。"能逐行就别全读",是大文件处理的黄金法则。
综合实战:读成绩文件算平均分
total = 0
count = 0
with open("scores.txt", "r", encoding="utf-8") as f:
for line in f:
score = int(line.strip()) # 去掉换行,转成数字
total += score
count += 1
print(f"共 {count} 个成绩,平均分:{total / count:.1f}")
逐行拆解:
- total = 0 / count = 0:累加器和计数器(第 8 章的套路);
- for line in f::逐行读;
- score = int(line.strip()):一行一个成绩,strip() 去 \n,int() 转数字;
- total += score / count += 1:累加、计数;
- print(f"...{total / count:.1f}"):平均分保留一位小数(第 4 章的 f-string 格式)。
假设 scores.txt 里是:
80
90
70
运行输出:
共 3 个成绩,平均分:80.0
配套代码文件:code/ch19/read_scores.py。
💡 现在你已经能"读文件 → 处理 → 统计"了。下一章学了异常处理,再给这个程序加一道保险:文件不存在时不崩溃,而是友好提示。
【皮皮小课堂】本章要点
- 写文件:
open(文件名, "w", encoding="utf-8")→write()→ 关闭。 - 读文件:
open(文件名, "r", encoding="utf-8")→read()/readline()→ 关闭。 - 模式:
"w"写入(清空)、"r"读取、"a"追加。 - with 语句:
with open(...) as f:代码块结束自动关闭,优先使用。 - 编码:读中文文件一定写
encoding="utf-8",否则乱码。 - 逐行读:
for line in f:处理大文件不爆内存。 "w"会清空原文件,要保留内容用"a"。write()不自动换行,\n要自己写;读到的行带\n,用strip()清。
【翻车现场】本章的坑
坑 1:文件不存在就读 → FileNotFoundError
f = open("no_such_file.txt", "r") # ❌ 报错
用 "r" 读不存在的文件会报 FileNotFoundError。想"没有就建",用 "w" 或 "a";或者先判断文件在不在(第 29 章 os.path.exists),或者用异常处理兜底(第 20 章)。
坑 2:忘关文件 / 忘了 with
不 close() 或不用 with,文件被程序一直占着,别的程序可能没法读,数据也可能丢。用 with,一了百了。 更糟的是:写模式不关闭,缓冲区里的内容可能没真正写进硬盘。
坑 3:读中文乱码
open("diary.txt", "r") 没写 encoding="utf-8" → 中文变 ����。读写都显式写 encoding="utf-8"。
坑 4:"w" 模式误清空文件
f = open("重要数据.txt", "w") # ❌ 一个不小心,原内容全没了!
"w" 会先清空。要续写、要保留,用 "a"。写代码前想清楚:我是要覆盖还是要追加? 这条坑一旦踩了,数据是找不回来的。
坑 5:读出来的行有换行符
readline() 和 for line in f 读到的行末尾带着 \n,直接 print 会出现"空行"。用 strip() 去掉。
坑 6:write 忘写换行符
with open("note.txt", "w", encoding="utf-8") as f:
f.write("第一行")
f.write("第二行") # ❌ 结果:"第一行第二行"
write() 不会自动换行。想让它是两行,必须自己加 \n。"write 一次 = 写一段,想换行自己动手。"
【本章习题】
一、选择题
1. (★) 用哪个模式打开文件,可以在末尾追加内容而不清空原来的?
- A.
"r" - B.
"w" - C.
"a" - D.
"x"
2. (★★) 下面哪个操作会报错?
- A.
open("a.txt", "w")(文件不存在) - B.
open("a.txt", "r")(文件不存在) - C.
open("a.txt", "a")(文件不存在) - D.
open("a.txt", "w")(文件存在)
3. (★★) with open("f.txt", "r") as f: 的作用是?
- A. 打开文件但永不关闭
- B. 打开文件,代码块结束后自动关闭
- C. 打开文件并立即删除
- D. 只能用于写文件
4. (★★) 下面代码运行时,如果 scores.txt 里存的是 80\n90\n70\n,输出的平均分是?
total = 0
count = 0
with open("scores.txt", "r", encoding="utf-8") as f:
for line in f:
score = int(line.strip())
total += score
count += 1
print(f"平均分:{total / count}")
- A.
平均分:80.0 - B.
平均分:90.0 - C.
平均分:240.0 - D. 报错
5. (★★ 多选) 关于文件操作,下列说法正确的是?
- A. 读取中文文件时,建议显式指定
encoding="utf-8" - B.
"w"模式会清空文件的原有内容 - C.
for line in f:可以逐行读取大文件,节省内存 - D.
f.write()会自动在每行末尾加换行符
二、判断题
1. (★) open("x.txt", "w") 时,如果 x.txt 不存在,会自动创建。( )
2. (★★) 用 with open(...) 后,就不需要手动调用 f.close()。( )
3. (★★) "a" 模式打开文件时,如果文件不存在会报错。( )
4. (★★) readline() 读到的每一行末尾都带着换行符 \n。( )
三、代码纠错题
1. (★★) 下面的代码想往文件里写两行,但结果只有一行,请指出问题:
with open("note.txt", "w", encoding="utf-8") as f:
f.write("第一行")
f.write("第二行")
2. (★★) 下面的代码运行时报 FileNotFoundError,请指出原因并改正(要求:文件不存在时不报错,而是提示用户):
with open("config.txt", "r", encoding="utf-8") as f:
content = f.read()
print(content)
四、编程实战题
1. (基础 ★) 用 with 往 memo.txt 里写入三行备忘(比如"1. 学 Python"、"2. 做习题"、"3. 睡觉"),再读出来打印。
2. (基础 ★★) 写程序:读入一个 .txt 文件,统计并输出它有多少行、多少个字符(含换行)。
3. (基础 ★★) 写一个"成绩单程序":从 scores.txt 逐行读取成绩(每行一个数字),输出总分、平均分、最高分和最低分(提示:max/min 函数,或自己维护最大值最小值)。
4. (挑战 ★★★) 写一个"记事本小程序":循环让用户输入内容,每输入一行就追加写入 notes.txt;输入 quit 结束,然后打印整个笔记文件的内容。
【参考答案与解析】
一、选择题
1. 答案:C
"a"(append)追加,不清空。"w" 会清空,"r" 只能读。
2. 答案:B
"r" 读取不存在的文件会报 FileNotFoundError。"w" 和 "a" 不存在都会自动创建。
3. 答案:B
with 语句的威力:代码块结束自动关闭文件。
4. 答案:A
3 个成绩 80+90+70=240,240 / 3 = 80.0。int(line.strip()) 把每行的"80"等转成数字。
5. 答案:A、B、C
A 对:指定编码防乱码;B 对:"w" 清空;C 对:for line in f 逐行读省内存;D 错:write() 不会自动换行,得自己写 \n。
二、判断题
1. 正确(√)。"w" 和 "a" 都会自动创建不存在的文件。
2. 正确(√)。with 块结束自动关闭,不用手动 close()。
3. 错误(×)。"a" 追加模式,文件不存在时自动创建,不报错。只有 "r" 读不存在才报错。
4. 正确(√)。readline() 和 for line in f 读到的行都带末尾 \n(最后一行无 \n 时除外)。
三、代码纠错题
1. 解析: write() 不会自动换行,两行内容会挤成 "第一行第二行"。改正:在每行末尾加 \n:
with open("note.txt", "w", encoding="utf-8") as f:
f.write("第一行\n")
f.write("第二行\n")
2. 解析: config.txt 不存在,"r" 模式读取报 FileNotFoundError。三种改法任选:
# 改法 1:用异常处理兜底(下一章正式学)
try:
with open("config.txt", "r", encoding="utf-8") as f:
content = f.read()
print(content)
except FileNotFoundError:
print("config.txt 不存在,已使用默认配置")
# 改法 2:文件不存在时创建它
if not __import__("os").path.exists("config.txt"):
with open("config.txt", "w", encoding="utf-8") as f:
f.write("默认配置")
with open("config.txt", "r", encoding="utf-8") as f:
print(f.read())
核心: 读文件前,先想好"文件不存在时该怎么办"。
四、编程实战题
1. 参考代码:
with open("memo.txt", "w", encoding="utf-8") as f:
f.write("1. 学 Python\n")
f.write("2. 做习题\n")
f.write("3. 睡觉\n")
with open("memo.txt", "r", encoding="utf-8") as f:
print(f.read())
2. 参考代码:
filename = "memo.txt" # 换成你要统计的文件
lines = 0
chars = 0
with open(filename, "r", encoding="utf-8") as f:
for line in f:
lines += 1
chars += len(line) # len 统计这一行有几个字符(含换行符)
print(f"行数:{lines}")
print(f"字符数:{chars}")
3. 参考代码:
scores = []
with open("scores.txt", "r", encoding="utf-8") as f:
for line in f:
scores.append(int(line.strip()))
if scores:
print(f"总分:{sum(scores)}")
print(f"平均分:{sum(scores) / len(scores):.1f}")
print(f"最高分:{max(scores)}")
print(f"最低分:{min(scores)}")
else:
print("文件里没有成绩")
解析: 先把所有成绩读进列表,再用 sum/max/min/len 统计——这就是第 11 章列表知识的用武之地。用 if scores: 判断列表非空,避免空列表 max() 报错。
4. 参考代码:
with open("notes.txt", "a", encoding="utf-8") as f:
while True:
text = input("请输入一行(输入 quit 结束):")
if text == "quit":
break
f.write(text + "\n")
print("\n--- 你的笔记 ---")
with open("notes.txt", "r", encoding="utf-8") as f:
print(f.read())
🐍"皮皮注:到这里,你已经能把用户输入永久保存到硬盘了。恭喜,你的程序正式拥有'长期记忆'。下一章给它穿防弹衣——异常处理。"
📖 下一章,给程序穿上防弹衣:try / except,让程序摔倒了也能爬起来。