“做一个文件整理工具”听起来很明确,实际却包含不少选择:整理哪个目录、按什么规则分类、是否移动原文件、遇到重名文件怎么办。如果直接开始写代码,这些问题会在开发过程中陆续出现,让原本简单的任务越来越难收尾。

先写出输入和输出

先用普通语言描述:工具接收什么,最后应该给出什么。描述里尽量使用具体对象,少用“智能”“完善”“好用”这类难以验证的词。

以文件整理为例

输入:一个指定文件夹中的文件列表。

输出:按扩展名分组的文件清单,显示每组的文件名和数量。

第一版的范围:只生成清单,暂不移动或删除任何文件。

这样就可以先验证分类规则是否合理,同时避免在规则还不清楚时修改原始数据。真正执行移动操作,可以放到后续版本单独处理。

找到一条最短的完整路径

把第一版拆成一组能够依次完成的动作。每个动作都应该有一个看得见的结果,例如“读取目录后,能够打印出文件名”,而不只是“完成读取模块”。

  1. 手动准备一个只含少量文件的测试目录。
  2. 读取该目录,得到文件列表。
  3. 提取扩展名,形成分组。
  4. 输出清单,与人工整理的结果比较。

这条路径完成后,工具就已经有了最小的可用结果。界面、美化、更多分类规则,都可以围绕这个结果逐步增加。

把容易忽略的情况单独列出来

正常示例跑通后,再检查边界情况:空文件夹、没有扩展名的文件、大小写不同的扩展名、无法读取的目录。先写出期望行为,再决定如何实现。

例如,无法读取目录时,应当清楚提示失败原因;空目录则应显示“没有找到文件”。这两种结果虽然都没有文件清单,含义却完全不同。

完成标准要能直接检查

为任务写一句明确的完成标准:“指定测试目录中的每个普通文件都出现在清单中,分组数量与人工统计一致,原文件保持原样。”检查这些条件,比凭感觉判断“差不多完成了”更可靠。

先完成一条能验证的路径,再增加下一项能力。小步骤的价值,是每一步都能带来明确的反馈。