大家好，欢迎来到 Crossin 的编程教室。
刚学完 Python 的基础语法（变量、列表、循环、函数），很多小伙伴都会陷入一个迷茫期：“语法我好像都看懂了，但怎么一到自己写项目，大脑就一片空白呢 ？”
学了语法不会做项目，那是缺乏一个把知识点串起来的“抓手”。今天 Crossin 带大家来做个几乎每个程序员入门都绕不开的经典练手项目——To-Do-List（待办事项管理工具）。
这个项目虽然小，但它能帮你一口气把数据的存储、增删改查逻辑、用户交互这些基本功全部打通。
1. To-Do-List 的底层逻辑
在动手前，别把这个工具想得太复杂，在计算机眼里，它其实就是一个“智能列表”：
任务内核 = 一个列表（List）：整个待办清单就是一个大箱子，里面放着一条条任务。
单个任务 = 一个带标签的字典（Dict）：比如 {"task": "背10个单词", "done": False}。task 是内容，done 代表是否完成。
核心操作 = 经典的 CRUD：添加任务（Create）、查看任务（Read）、勾选完成（Update）、删除任务（Delete）。
是不是瞬间清晰了？接下来，我们就用纯 Python 把逻辑一步步变成现实。
2. 核心功能模块拆解
接下来我们将采用模块化拆解，一步步来凑齐这个工具的核心拼图：
2.1. 数据初始化与查看任务
首先，我们需要一个容器来装任务，并且能把它们整齐地打印出来。
如果是已完成的任务，前面打个 `[X]`，未完成的打个 `[ ]`。
todo_list = []
def show_tasks(): if not todo_list: print("\n当前暂无待办事项，快去添加一个吧！") return
print("\n====== 我的待办清单 ======") for index, item in enumerate(todo_list, 1): 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): todo_list[index - 1]["done"] = True print(f"任务 {index} 已标记为完成！")
def delete_task(index): removed = todo_list.pop(index - 1) print(f"已成功删除任务：{removed['task']}")
3. 完整交互代码
有了上面的功能块，我们用一个 while True 循环把它们缝合在一起，配上用户输入提示，一个完整的命令行工具就诞生了！
这里我们额外加入一些异常处理，防止用户瞎输入导致程序崩溃。
把下面的代码保存为一个 `.py` 文件，直接运行即可：
todo_list = []
def show_tasks(): if not todo_list:
print("\n当前暂无待办事项，快去添加一个吧！") return print("\n====== 我的待办清单 ======") 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("\n请输入操作指令：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("无效的指令，请重新输入！")
4. 新手错误避坑
写这类管理工具时，有些隐形坑很容易让人抓狂，写的时候一定要注意“避坑”：
4.1. 类型不匹配：明明输入了序号，程序却一直提示错误。
input() 接收到的所有内容默认都是字符串（比如 '1'）。必须用 int() 函数强转成整数，才能用来做列表的索引或数字对比。
4.2. 索引越界（IndexError）：输入了一个过大的数字，程序直接闪退报错。
列表的长度是动态的。在将用户输入的序号作为索引去拿数据前，必须先用 1 <= num <= len(todo_list) 进行判断，避免越界。
4.3. 中文输入法导致语法错误（SyntaxError）
代码里的冒号 :、中括号 [] 必须全是英文半角字符。新手写代码 80% 的报错都是因为不小心切到了中文输入法。
5. 总结与扩展
编程能力的提高是需要不断练习的，看懂≠学会。与其反复找教程学习，不如亲手打开 IDE，实现一个能成功添加、删除、完成任务的 To-Do-List 工具。
在这个骨架的基础上，你还可以给它添砖加瓦，例如：
还想了解什么编程知识点或者开发案例，可以来评论区留言。
如果本文对你有帮助，欢迎点赞、评论、转发。你们的支持是我更新的动力~
添加微信 crossin123 ，加入编程教室共同学习~
