Python命令行待办清单入门：文件读写、异常处理与小工具思维

很多初学者学完 Python 基础语法后，都会问下一个问题：能做点真正有用的东西吗？命令行待办清单就是一个很好的起点。它没有复杂的界面，却完整地包含了一个小工具的核心环节：接收输入、保存数据、读取数据、处理异常和给出反馈。把这一个小工具做扎实，比同时开十个半途而废的项目更有收获。

一、为什么从待办清单开始

待办清单的需求非常真实：记下来、看一看、做完划掉。它的状态很简单，每条任务只需要一句话和一个是否完成标记。正因为需求清晰，我们可以把精力放在程序结构上，而不是纠结界面细节。更重要的是，这个项目可以不断扩展：先实现添加和查看，再加上删除、标记完成、按状态筛选，最后还可以加上截止日期和优先级。

二、先想清楚数据怎么存

新手常犯的错误是直接写代码，写到一半才发现不知道数据放在哪里。一个简单可靠的起点是把任务存在一个文本文件里，每行一条，前面加一个标记表示是否完成。例如用 [ ] 表示未完成，用 [x] 表示已完成。这样即使程序退出，数据也不会丢失，打开文件也能直接看懂。等熟悉之后，再换成 JSON 格式，用结构化的方式保存标题、完成状态和创建时间，程序会更清晰。

三、把功能拆成小函数

一个好的习惯是把程序拆成几个职责单一的小函数：加载任务、保存任务、添加任务、列出任务、标记完成。主程序只负责读懂用户的命令，然后调用对应的函数。这样做的好处很明显：某个功能出问题时，定位范围很小；想加新功能时，也不用把整个文件翻一遍。写代码之前，可以先在纸上列出这几个函数名和它们的参数，这一步花不了几分钟，却能省下很多返工。

四、异常处理不是可有可无的装饰

命令行工具最容易在真实使用中崩溃：用户输入了不存在的编号、文件被误删、输入了空内容。如果程序直接抛出难懂的错误，体验会很差。正确的做法是把可能出错的地方包起来，给出人能看懂的提示。比如编号超出范围时提示“没有这条任务，请先查看列表”；文件不存在时不要崩溃，而是当作空清单重新开始；用户输入空任务时提醒“任务内容不能为空”。异常处理的目的不是掩盖错误，而是把错误翻译成下一步可以做什么。

五、一个可以跑起来的最小版本

最小版本不需要一次做到完美，只需要能完成闭环：启动程序，输入添加命令记下买牛奶，输入查看命令看到这条任务，输入完成命令把它标记完成，再查看确认它已经打勾。跑通这个闭环后，再慢慢加功能。每次只加一个功能，跑通再加下一个，这是小工具开发最稳妥的节奏。很多项目失败不是因为技术太难，而是因为一开始就想做得太多。

六、从能用到好用的三个习惯

第一，给每个命令写一句帮助提示，用户不用猜。第二，保存之后立刻能验证，先存后读，确认数据真的落盘了。第三，定期整理代码，把重复的逻辑抽成函数，把容易写错的编号处理放在同一个地方。这些习惯看起来琐碎，却是区分“能跑的代码”和“能维护的工具”的关键。

结语

不要小看命令行小工具。它教会你的不只是文件读写和异常处理，更是一种做产品的思路：先解决一个真实的小问题，再让它稳定、清晰、可扩展。完成这个待办清单后，你可以顺着同样的思路，做一个读书清单、记账小工具或者习惯打卡器。工具会越做越多，能力也会在一次次“做完一个完整的东西”中真正长出来。