一句话:提出 TDCleaner 模型,利用神经编码器自动识别软件项目中已过时的 TODO 注释,支持即时检查与自动清理。
开发者常用 TODO 注释记录待办任务,但任务完成后常忘记删除,从而产生过时 TODO 注释,误导团队并可能引入缺陷。本文提出 TDCleaner 模型,分离线学习与在线预测两阶段:离线阶段自动构建训练样本,用三个神经编码器分别捕获 TODO 注释、代码变更与提交信息的语义特征,并学习三者间的关联与交互以判定 TODO 状态;在线阶段用训练好的模型实时评估某条 TODO 是否已过时。作者从 GitHub 前 1 万个 Python 与 Java 仓库收集 TODO 构建数据集,在多个基准上评估模型,并在真实项目中开展实地验证:向开发者报告 18 条过时 TODO,其中 9 条已被确认并删除。
TODO comments are very widely used by software developers to describe their pending tasks during software development. However, after performing the task developers sometimes neglect or simply forget to remove the TODO comment, resulting in obsolete TODO comments. These obsolete TODO comments can confuse development teams and may cause the introduction of bugs in the future, decreasing the software's quality and maintainability. Manually identifying obsolete TODO comments is time-consuming and expensive. It is thus necessary to detect obsolete TODO comments and remove them automatically before they cause any unwanted side effects. In this work, we propose a novel model, named TDCleaner, to identify obsolete TODO comments in software projects. TDCleaner can assist developers in just-in-time checking of TODO comments status and avoid leaving obsolete TODO comments. Our approach has two main stages: offline learning and online prediction. During offline learning, we first automatically establish training samples and leverage three neural encoders to capture the semantic features of TODO comment, code change and commit message respectively. TDCleaner then automatically learns the correlations and interactions between different encoders to estimate the final status of the TODO comment. For online prediction, we check a TODO comment's status by leveraging the offline trained model to judge the TODO comment's likelihood of being obsolete. We built our dataset by collecting TODO comments from the top-10,000 Python and Java Github repositories and evaluated TDCleaner on them. Extensive experimental results show the promising performance of our model over a set of benchmarks. We also performed an in-the-wild evaluation with real-world software projects, we reported 18 obsolete TODO comments identified by TDCleaner to Github developers and 9 of them have already been confirmed and removed by the developers, demonstrating the practical usage of our approach.