Skip to content

第 19 章:综合项目 ​

本章在知识链中的位置:这是正文的最后一章,前面第 1~18 章讲过的变量、判断、循环、函数、列表、字典、文件读写、标准库,本章全部都会用到,不再引入新知识。

本章能学到什么 ​

  • 拿到一个较大的需求时,怎样把它拆成若干个已经学过的小问题
  • 从零到一完成三个完整项目:猜数字升级版、成绩管理系统、文本分析器
  • 每个项目"还能怎么改"的拓展方向

从零件到整车 ​

前 18 章学的内容,像一盒分好类的乐高零件:变量是砖块,循环和判断是关节,函数是可以反复拆装的组件,文件读写是电线。零件单独看都不难,难的是把它们组装成一辆能跑的车。

本章做三辆车,一辆比一辆大。每个项目都按同样的三步走:先拆需求,再写代码,最后想拓展。其中第一步是本章的重点——会拆问题的人,换任何一门语言都能很快上手。

项目一:猜数字游戏升级版 ​

需求拆解 ​

第 6 章做过一个猜数字游戏:程序想好一个 1~100 的数,玩家反复猜,程序提示"大了"或"小了",直到猜中。现在要给它升级:记录历史最好成绩(最少用几次猜中),保存到文件里,下次启动时显示。

拿到这个需求,先不急着写代码。拿出纸笔,问一连串小问题:

小问题对应学过的内容
数从哪里来?随机数,random.randint(第 18 章)
玩家猜的次数怎么记下来?一个变量,每猜一次加 1(第 1、6 章)
"大了/小了/猜中了"怎么判断?if / elif / else(第 5 章)
没猜中就继续问,猜中就停,怎么写?while 循环(第 6 章)
最好成绩存到哪里?一个文本文件 best.txt(第 15 章)
文件还不存在怎么办?第一次玩时没有历史成绩,用 try/except 兜住(第 16 章)
什么时候更新最好成绩?本次次数 < 历史最好成绩时(第 2 章比较运算)

拆完之后再排一下执行顺序,程序的"骨架"就出来了:

  1. 读 best.txt,得到历史最好成绩(没有就当作"第一次玩")
  2. 生成随机答案,显示提示
  3. 循环:读入玩家猜的数 → 计次 → 提示大小,直到猜中
  4. 公布答案和本次次数
  5. 如果破了纪录,把新成绩写回 best.txt

骨架里每一格都对应一章学过的内容,没有任何一格是"不会"的。这就是拆问题的意义:大问题只是小问题的排队。

动手之前还有两个小决定要做,它们不来自需求描述,而是来自经验:

  • "没有历史成绩"用什么表示? 文件不存在时 load_best 返回 None。None 是 Python 里专门的"空值",和任何整数都不会混淆,天然适合当"暗号"。这种"用一个特殊值表示没有"的做法,在编程里叫哨兵值。
  • 先写哪一部分? 从最小的开始:先写读写文件的两个函数并单独测试,再写主循环。每写完一块就跑一遍,错误永远暴露在刚写的那几行里,而不是最后一起爆发。

完整代码 ​

python
import random  # 随机数模块(第 18 章)

def load_best():
    """读取历史最好成绩;文件不存在时返回 None,表示"还没有记录"。"""
    try:
        with open("best.txt", "r", encoding="utf-8") as f:
            return int(f.read().strip())  # 读出来是字符串,转成整数
    except FileNotFoundError:
        return None

def save_best(best):
    """把最好成绩写进文件(覆盖旧内容)。"""
    with open("best.txt", "w", encoding="utf-8") as f:
        f.write(str(best))

answer = random.randint(1, 100)  # 1~100 的答案

best = load_best()
if best is not None:
    print(f"历史最好成绩:{best} 次")
else:
    print("这是第一次玩,还没有历史成绩。")

print("我想好了一个 1~100 的数,猜猜看!")

guess = 0
count = 0
while guess != answer:
    guess = int(input("请输入你猜的数:"))
    count += 1
    if guess > answer:
        print("大了!")
    elif guess < answer:
        print("小了!")

print(f"猜对了!答案是 {answer},共用 {count} 次。")

if best is None or count < best:  # 第一次玩,或者破了纪录
    save_best(count)
    print("新纪录!最好成绩已保存。")

运行示例 ​

第一次运行(best.txt 还不存在):

text
这是第一次玩,还没有历史成绩。
我想好了一个 1~100 的数,猜猜看!
请输入你猜的数:50
小了!
请输入你猜的数:75
大了!
请输入你猜的数:62
猜对了!答案是 62,共用 3 次。
新纪录!最好成绩已保存。

再次运行,程序会显示上次保存的最好成绩。随机答案每次不同,上面的数字只是示例。《C++ 从入门到精通》 第 19 章里有同一个游戏的 C++ 版本,输出格式完全相同。

还能怎么改 ​

  • 限制最多猜 7 次,用完就公布答案(动手实验第 1 题)
  • 加一层外层循环,猜中后问"再来一局吗"
  • 把每一局的次数追加到文件末尾,形成一张"战绩表"

项目二:成绩管理系统 ​

需求拆解 ​

老师手里有一张成绩表:每个学生的姓名和语文、数学、英语分数。想让程序帮忙做五件事:录入、查看、按总分排序、统计(人数、平均分、最高分、最低分)、保存到文件并且下次打开还能读回来。

老办法,先拆:

小问题对应学过的内容
一个学生的数据怎么装?字典:姓名 + 三门成绩(第 12 章)
全班学生放在哪?列表,每个学生是一个字典(第 10 章)
五件事怎么让玩家选?菜单 + while 循环 + if/elif(第 5、6 章)
总分怎么算?一个函数 total(),三科相加(第 7 章)
按总分排序怎么做?sort(key=...)(第 11 章)
统计怎么做?遍历列表,累加、比较(第 6、10 章)
存成什么文件格式?一行一个学生,逗号分隔(CSV 格式,第 15 章)
启动时旧数据怎么回来?打开文件逐行读,按逗号切开(第 9、15 章)

有一个新问题值得单独想一想:文件里每一行长什么样? 这是程序员自己定的规则,定得越简单越好。这里约定:一行一个学生,姓名和三科成绩用逗号隔开:

text
小明,88,95,92
小红,90,85,91

这种格式叫 CSV,Excel 也能直接打开。读取时用第 9 章的 split(","),按逗号切成四段即可。

菜单的骨架和项目一类似:循环显示菜单,读入选项,用 if / elif 分发到对应功能,选 5 就保存并退出。

拆解时还有一个容易漏掉的环节:数据在内存里和在文件里,是两种形态。程序运行时,学生数据是"字典的列表";保存时,要"压扁"成一行行文本;下次启动,再从文本"还原"成字典。压扁和还原这两个方向各写一个函数(save 和 load),读写规则就集中在一处,以后要改文件格式,只动这两个函数。

写代码的顺序建议:先写 total,再写菜单空壳(每个选项只打印一句话),确认菜单能跑通之后,逐个填进 show_all、stats、排序和文件读写。空壳先跑通,骨架就不会歪。

完整代码 ​

python
FILENAME = "scores.csv"

def total(s):
    """总分(第 7 章:把重复用到的计算写成函数)。"""
    return s["chinese"] + s["math"] + s["english"]

def load():
    """启动时从文件读回全部学生;文件不存在就返回空名单。"""
    students = []
    try:
        with open(FILENAME, "r", encoding="utf-8") as f:
            for line in f:
                line = line.strip()
                if not line:
                    continue  # 跳过空行
                name, c, m, e = line.split(",")  # 按逗号切成四段
                students.append({"name": name, "chinese": int(c),
                                 "math": int(m), "english": int(e)})
    except FileNotFoundError:
        pass  # 第一次运行时文件还不存在
    return students

def save(students):
    """把全部学生写回文件。"""
    with open(FILENAME, "w", encoding="utf-8") as f:
        for s in students:
            f.write(f"{s['name']},{s['chinese']},{s['math']},{s['english']}\n")

def show_all(students):
    """查看全部。"""
    if not students:
        print("(还没有任何记录)")
        return
    print("姓名\t语文\t数学\t英语\t总分")
    for s in students:
        print(f"{s['name']}\t{s['chinese']}\t{s['math']}\t{s['english']}\t{total(s)}")

def stats(students):
    """统计:人数、平均总分、最高总分、最低总分。"""
    if not students:
        print("(还没有任何记录)")
        return
    totals = [total(s) for s in students]
    print(f"人数:{len(students)}")
    print(f"全班平均总分:{sum(totals) / len(totals)}")
    print(f"最高总分:{max(totals)}")
    print(f"最低总分:{min(totals)}")

def main():
    students = load()  # 启动时先读回旧数据

    while True:
        print("\n===== 成绩管理系统 =====")
        print("1. 录入成绩")
        print("2. 查看全部")
        print("3. 按总分排序")
        print("4. 统计")
        print("5. 保存并退出")
        choice = input("请选择:")

        if choice == "1":
            s = {}
            s["name"] = input("姓名:")
            s["chinese"] = int(input("语文:"))
            s["math"] = int(input("数学:"))
            s["english"] = int(input("英语:"))
            students.append(s)
            print("已录入。")
        elif choice == "2":
            show_all(students)
        elif choice == "3":
            students.sort(key=total, reverse=True)  # key=total:按总分排
            print("已按总分从高到低排序。")
            show_all(students)
        elif choice == "4":
            stats(students)
        elif choice == "5":
            save(students)
            print(f"已保存到 {FILENAME},再见!")
            break
        else:
            print("没有这个选项,请重新选择。")

main()

运行示例 ​

text
===== 成绩管理系统 =====
1. 录入成绩
2. 查看全部
3. 按总分排序
4. 统计
5. 保存并退出
请选择:1
姓名:小明
语文:88
数学:95
英语:92
已录入。

(再录入一名学生:小红,语文 90、数学 85、英语 91)

请选择:3
已按总分从高到低排序。
姓名	语文	数学	英语	总分
小明	88	95	92	275
小红	90	85	91	266

请选择:4
人数:2
全班平均总分:270.5
最高总分:275
最低总分:266

请选择:5
已保存到 scores.csv,再见!

退出后用记事本打开 scores.csv,能看到两行逗号分隔的数据;再次运行程序,旧数据会自动读回来。

还能怎么改 ​

  • 增加"按姓名查找"功能(动手实验第 2 题)
  • 增加"删除一名学生"功能
  • 统计每一科的平均分,而不只是总分
  • 输入非法成绩(比如超过 100 或小于 0)时拒绝录入

项目三:简单文本分析器 ​

需求拆解 ​

Word 文档的底部状态栏会显示"字数:xxx"。本章最后一个项目,自己做一个简化版:读入一篇英文文本文件,统计行数、单词数、字符数,再列出出现次数最多的 5 个单词(词频 Top 5)。

照旧先拆:

小问题对应学过的内容
文件怎么一行一行读?for line in f(第 15 章)
行数怎么数?每读一行,计数器加 1(第 1 章)
字符数怎么数?每行的长度累加(第 9 章)
一行怎么切成单词?按空格切,split()(第 9 章)
"Hello" 和 "hello" 算同一个词吗?算。统一转成小写(第 9 章)
"stopped." 后面的句号怎么办?清洗:只保留字母(第 5、9 章)
每个单词出现几次怎么记?字典:单词 → 次数(第 12 章)
Top 5 怎么取?sorted 按次数排序,切片取前 5(第 11 章)

这次有一个拆解时要想清楚的细节:排序规则有两层——次数多的在前;次数相同时按字母顺序。两层规则都写进排序依据里,每次运行的结果才完全一样。

清洗单词这一步也值得多说一句。直接按空格切出来的"单词"带着各种外衣:Hello 首字母大写,stopped. 拖着句号,(a) 裹着括号。不清洗的话,Hello 和 hello 会被当成两个词,统计就失真了。清洗的规则自己定,定一条简单明确的:只保留字母、统一小写。规则越简单,代码越不容易出错。

排序依据 (-item[1], item[0]) 是一个二元组:Python 比较两个元组时,先比第一个元素,相同再比第二个。次数前面加负号,是让"次数多"变成"数值小",从而排在前面——一个用数学变换借用排序功能的常见技巧。

准备材料 ​

先在程序旁边建一个文件 article.txt,写入一段英文:

text
The little turtle walked slowly but never stopped.
Day by day it learned a little more.
Small steps every day add up to a long journey.
Keep going and you will get there.

完整代码 ​

python
FILENAME = "article.txt"

def clean(word):
    """清洗单词:只保留字母,并统一转成小写。"""
    return "".join(ch for ch in word if ch.isalpha()).lower()

def order_key(item):
    """排序依据:次数多的在前(加负号实现从大到小);次数相同按字母顺序。"""
    return (-item[1], item[0])

lines = 0    # 行数
chars = 0    # 字符数(不含换行符)
freq = {}    # 单词 → 出现次数

with open(FILENAME, "r", encoding="utf-8") as f:
    for line in f:                    # 每次读一行
        lines += 1
        chars += len(line.rstrip("\n"))
        for word in line.split():     # 按空格逐个取出单词
            word = clean(word)
            if word:
                freq[word] = freq.get(word, 0) + 1  # 计数加 1

words = sum(freq.values())            # 次数之和就是总词数

# 按排序依据排列,切片取前 5 个
top5 = sorted(freq.items(), key=order_key)[:5]

print(f"行数:{lines}")
print(f"单词数:{words}")
print(f"字符数:{chars}")
print("词频 Top 5:")
for word, count in top5:
    print(f"  {word}:{count} 次")

运行示例 ​

text
行数:4
单词数:33
字符数:167
词频 Top 5:
  day:3 次
  a:2 次
  little:2 次
  add:1 次
  and:1 次

换成任何一篇英文文章(复制粘贴到 article.txt),程序都能给出统计。中文文本的"切词"需要专门的分词工具,超出了本书范围,不过行数和字符数的统计对中文同样有效——这也是拓展练习的方向。

还能怎么改 ​

  • 统计用户指定的某个单词出现了几次(动手实验第 3 题)
  • 把 Top 5 改成 Top 10,名次由用户输入
  • 把统计结果写入另一个文件,形成一份"分析报告"
  • 对中文文本,统计每个汉字出现的次数(把"按空格切词"换成"逐字统计")

写大程序的三个习惯 ​

三个项目加起来几百行代码,比前面任何一章的示例都长。行数上去了,三个习惯的价值就显出来了:

习惯具体做法
小块快跑每写完一个函数就运行一次,不等全部写完
注释写"为什么"代码本身已经说明"做了什么",注释留给"为什么这样做"
命名当文档load_best、show_all 这样的名字,半年后重读也能看懂

写在最后 ​

三个项目做完了。回头看,每个项目的第一件事都不是写代码,而是拿纸笔拆问题。拆得越细,写起来越顺;拆到每一格都能说出"这是第几章学的",代码就只剩下翻译工作。

这种"先拆再写"的习惯,比任何一条语法都重要。语法换一门语言就要重新适应,拆解问题的能力却可以带走一辈子。

动手实验 ​

  1. 给猜数字游戏加上次数限制:最多猜 7 次,用完还没猜中就公布答案。

  2. 给成绩管理系统增加第 6 个菜单项"按姓名查找":输入姓名,输出该学生的总分;找不到就提示。

  3. 改造文本分析器:程序启动时先问"要统计哪个单词",读入后额外输出这个单词出现的次数。

💡 查看答案

第 1 题:把项目一的循环条件改成"没猜中且次数未满",循环结束后再判断是猜中了还是没机会了。

python
guess = 0
count = 0
while guess != answer and count < 7:  # 两个条件同时满足才继续
    guess = int(input("请输入你猜的数:"))
    count += 1
    if guess > answer:
        print("大了!")
    elif guess < answer:
        print("小了!")

if guess == answer:
    print(f"猜对了!答案是 {answer},共用 {count} 次。")
    if best is None or count < best:
        save_best(count)
        print("新纪录!最好成绩已保存。")
else:
    print(f"机会用完了,答案是 {answer}。")

第 2 题:在菜单里加一行 6. 按姓名查找,再加一个分支。

python
elif choice == "6":
    key = input("要查找的姓名:")
    found = False
    for s in students:
        if s["name"] == key:
            print(f"{s['name']} 的总分是 {total(s)}")
            found = True
    if not found:
        print("没有找到这个名字。")

第 3 题:在打开文件之前先读入目标单词并清洗,统计完成后单独取值。

python
target = input("要统计哪个单词?")
target = clean(target)  # 同样转成小写、去标点

# ……统计词频的循环保持不变……

n = freq.get(target, 0)  # get 的第二个参数:没出现过就返回 0
print(f"单词 {target} 出现了 {n} 次")

字典的 get 方法在第 12 章讲过:键不存在时返回指定的默认值,不会像 freq[target] 那样报错。