首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Python新手进阶经典案例:从零实现一个To-Do-List(待办事项)工具

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

作者头像
Crossin先生
发布2026-06-25 19:48:49
发布2026-06-25 19:48:49
260
举报

大家好,欢迎来到 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]`,未完成的打个 `[ ]`。

代码语言:javascript
复制
# 1. 初始化一个空列表来装所有任务
todo_list = []

# 2. 查看任务的函数
def show_tasks():
    if not todo_list:
        print("\n当前暂无待办事项,快去添加一个吧!")
        return

    print("\n====== 我的待办清单 ======")
    # 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. 添加、完成与删除任务

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

代码语言:javascript
复制
# 添加任务
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']}")

3. 完整交互代码

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

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

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

代码语言:javascript
复制
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 工具。

在这个骨架的基础上,你还可以给它添砖加瓦,例如:

  • 持久化存储:引入 json 模块,把任务保存到本地文件,这样下次打开程序时,之前写的任务不会消失。
  • 图形化界面:尝试用 Python 自带的 tkinter 库给它套上一个可视化的外壳。

还想了解什么编程知识点或者开发案例,可以来评论区留言。

如果本文对你有帮助,欢迎点赞、评论、转发。你们的支持是我更新的动力~


本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2026-06-24,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 Crossin的编程教室 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档