Python新手进阶经典案例：从零实现一个To-Do-List（待办事项）工具

原创

Crossin先生
Crossin先生

Crossin的编程教室

2026年6月24日 17:08
江苏

在小说阅读器读本章

去阅读

大家好，欢迎来到 Crossin 的编程教室。

刚学完 Python 的基础语法（变量、列表、循环、函数），很多小伙伴都会陷入一个迷茫期：“语法我好像都看懂了，但怎么一到自己写项目，大脑就一片空白呢？”

学了语法不会做项目，那是缺乏一个把知识点串起来的“抓手”。今天 Crossin 带大家来做个几乎每个程序员入门都绕不开的经典练手项目——To-Do-List（待办事项管理工具）。

这个项目虽然小，但它能帮你一口气把数据的存储、增删改查逻辑、用户交互这些基本功全部打通。

To-Do-List 的底层逻辑

在动手前，别把这个工具想得太复杂，在计算机眼里，它其实就是一个“智能列表”：

任务内核 = 一个列表（List）：整个待办清单就是一个大箱子，里面放着一条条任务。
单个任务 = 一个带标签的字典（Dict）：比如 {\"task\": \"背10个单词\", \"done\": False}。task 是内容，done 代表是否完成。
核心操作 = 经典的 CRUD：添加任务（Create）、查看任务（Read）、勾选完成（Update）、删除任务（Delete）。

是不是瞬间清晰了？接下来，我们就用纯 Python 把逻辑一步步变成现实。

核心功能模块拆解

接下来我们将采用模块化拆解，一步步来凑齐这个工具的核心拼图：

2.1. 数据初始化与查看任务

首先，我们需要一个容器来装任务，并且能把它们整齐地打印出来。

如果是已完成的任务，前面打个 [X]，未完成的打个 [ ]。

# 1. 初始化一个空列表来装所有任务todo_list = []
# 2. 查看任务的函数def show_tasks():    if not todo_list:        print(\"\
当前暂无待办事项，快去添加一个吧！\")        return
    print(\"\
====== 我的待办清单 ======\")    # enumerate 可以同时获取索引(从1开始)和任务内容    for index, item in enumerate(todo_list, 1):        # 根据 done 的状态决定打勾还是留空        status = \"[X]\" if item[\"done\"] else \"[ ]\"        print(f\"{index}. {status} {item['task']}\")    print(\"==========================\")

2.2. 添加、完成与删除任务

有了容器，接下来就是对里面的数据进行增、改、删了。

# 添加任务def add_task(task_name):    # 每条任务都是一个字典，默认未完成    new_task = {\"task\": task_name, \"done\": False}    todo_list.append(new_task)    print(f\"成功添加任务：{task_name}\")
# 标记任务完成def complete_task(index):    # 程序员数数从0开始，用户输入从1开始，所以要减1    todo_list[index - 1][\"done\"] = True    print(f\"任务 {index} 已标记为完成！\")
# 删除任务def delete_task(index):    removed = todo_list.pop(index - 1)    print(f\"已成功删除任务：{removed['task']}\")

完整交互代码

有了上面的功能块，我们用一个 while True 循环把它们缝合在一起，配上用户输入提示，一个完整的命令行工具就诞生了！

这里我们额外加入一些异常处理，防止用户瞎输入导致程序崩溃。

把下面的代码保存为一个 .py 文件，直接运行即可：

todo_list = []
def show_tasks():    if not todo_list:        print(\"\
当前暂无待办事项，快去添加一个吧！\")        return    print(\"\
====== 我的待办清单 ======\")    for index, item in enumerate(todo_list, 1):        status = \"[X]\" if item[\"done\"] else \"[ ]\"        print(f\"{index}. {status} {item['task']}\")    print(\"==========================\")
while True:    show_tasks()    print(\"\
请输入操作指令：1.添加任务  2.完成任务  3.删除任务  4.退出程序\")    choice = input(\"请选择 (1/2/3/4): \").strip()
    if choice == \"1\":        task_name = input(\"请输入要添加的任务内容: \").strip()        if task_name:            new_task = {\"task\": task_name, \"done\": False}            todo_list.append(new_task)            print(f\"成功添加任务：{task_name}\")        else:            print(\"任务内容不能为空！\")
    elif choice in [\"2\", \"3\"]:        if not todo_list:            print(\"当前清单为空，无法操作！\")            continue
        try:            num = int(input(f\"请输入要操作的任务序号 (1-{len(todo_list)}): \"))            if 1 <= num <= len(todo_list):                if choice == \"2\":                    todo_list[num - 1][\"done\"] = True                    print(f\"任务 {num} 已标记为完成！\")                else:                    removed = todo_list.pop(num - 1)                    print(f\"已成功删除任务：{removed['task']}\")            else:                print(\"输入的序号不在范围内，请重新输入！\")        except ValueError:            print(\"请输入有效的数字序号！\")
    elif choice == \"4\":        print(\"感谢使用，再见！\")        break    else:        print(\"无效的指令，请重新输入！\")