融合结构与语义特征的代码注释决策支持方法

• 作者: 周强 熊英飞 罗笑南 贾楠 陈湘萍 黄袁
• 来源期刊: 软件学报
• 学科: 工学
• 关键词: 代码注释 结构特征 语义特征 机器学习 注释决策
• 年，卷（期）: 2018,（8）
• 所属期刊栏目: 数据驱动的软件智能化开发方法与技术专题
• 页码范围: 2226-2242
• 页数: 17页
• 分类号: TP311
• 字数: 12956字
• 语种: 中文
• DOI: 10.13328/j.cnki.jos.005528

摘要

代码注释是辅助编程人员理解源代码的有效手段之一.高质量的注释决策不仅能够覆盖软件系统中的核心代码片段,还能避免产生多余的代码注释.然而在实际开发中,编程人员往往缺乏统一的注释规范,大部分的注释决策都取决于个人经验以及领域知识.对于新手程序员来说,注释决策显然成为一项重要而艰巨的任务.为了减少编程人员投入过多的精力在注释决策上,从大量的代码注释实例中学习出一种通用的注释决策规范,并提出了CommentAdviser方法,以辅助编程人员在代码开发过程中做出恰当的注释决策.由于注释决策与代码本身的上下文信息密切相关,因此,从当前代码行的上下文代码中提取代码结构特征以及代码语义特征作为支持注释决策的主要依据.然后,利用机器学习算法判定当前代码行是否为可能的注释点.在GitHub中的10个大型开源软件的数据集上评估了所提出的方法,实验结果以及用户调研表明,代码注释决策支持CommentAdviser方法的可行性和有效性.