与外界打交道 · 文件·异常·模块

第19章 和硬盘说悄悄话

文件读写

第 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()                                       # ③ 关闭

逐项解释:

运行后,当前目录下会出现一个 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" 不会清空原文件,只把内容加在末尾。适合做日志、做记录。

对比三种模式的"续写效果":

换例加深:模拟一个"记流水账"的小程序

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,读取时忘了指定,系统可能用了别的编码"瞎翻译"。好比日记用中文写的,你却用英文语法去读——当然看不懂。

皮皮的铁律:

# 读写含中文的文件,一律显式指定 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。

💡 现在你已经能"读文件 → 处理 → 统计"了。下一章学了异常处理,再给这个程序加一道保险:文件不存在时不崩溃,而是友好提示。


【皮皮小课堂】本章要点


【翻车现场】本章的坑

坑 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. (★) 用哪个模式打开文件,可以在末尾追加内容而不清空原来的?

2. (★★) 下面哪个操作会报错?

3. (★★) with open("f.txt", "r") as f: 的作用是?

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}")

5. (★★ 多选) 关于文件操作,下列说法正确的是?

二、判断题

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,让程序摔倒了也能爬起来。

📦 本章配套代码

运行方式:命令行进入目录后执行 py 文件名.py(Windows)或 python3 文件名.py(Mac/Linux)