代码注释(Code Comment)即用自然语言的形式论述代码背后实现的逻辑或功能,开发人员通过代码注释来认识掌握软件仓库中源代码描写的功能。软件开发随着互联网的迅猛发展也在不断高速发展,并伴随出现了大量的开源代码库。在软件开发过程中阅读并理解开源社区的源代码是一项耗时耗力的工作,如果源代码有相应的功能描述性注释,很大程度上简化并加快软件开发过程及速度,同时完善的代码注释也可以提高软件系统的可维护性。将软件仓库中的注释信息处理后映射到目标项目软件中的相似代码片段被称为注释复用(Comment Reuse)。程序解析(Program Parsing)即在优化注释的过程中会从代码和注释本身入手,分析代码的含义。但目前只有不到百分之二十的代码有对应的注释,开发人员如果手动为源代码添加注释,将消耗大量的人力与时间,因此自动生成代码注释成为研究领域的热门研究方向。现有的代码注释自动生成方法存在着一定的局限性,需要一种新的、有效的方法自动生成代码注释。本文以“自动生成代码注释”为切入点,针对注释数量稀少、质量不高的问题进行实验,为研究人员提供有价值、有参考意义的信息与数据。具体工作如下:1.基于克隆检测工具获得克隆检测结果并进行代码和注释的提取。注释复用的关键是找到软件仓库与目标项目软件的相似代码,然后进行提取。本文选用克隆检测的方式检测相似代码,检测工具选用Nicad,根据克隆检测结果对获得方法和语句的位置进行标记,设计多种启发式规则,结合这些规则从软件仓库的相应位置将克隆代码以及这些克隆代码对应的所有注释语句分别提取,构建注释候选列表,为接下来克隆代码的精简以及注释内容的优化提供基本数据。2.在已获取的克隆代码候选列表和注释候选列表的基础上,对克隆代码以及代码注释精简优化,获得高质量的克隆代码及代码注释。初步获取到的克隆代码和代码注释无论是自动生成还是手动撰写都存在克隆代码冗余、注释格式不规范、注释位置不合理、注释内容与代码不匹配等问题,通过一系列启发式规则以及程序解析的方法将克隆代码和代码注释优化。3.获取到高质量的代码和注释,进行“代码—注释”映射。获得的代码和注释有可能出现代码与注释是一对多的情况,通过计算代码段节点与注释节点重叠术语的数量,即相似性得分,将其进行排序,选择最高得分的代码注释进行映射,得到最终的文档。4.将得到的代码与注释映射文档进行多维度质量评估。人工评估自动生成的代码注释,选取具有Java编程经验的人员,为每位小组成员提供若干个随机选择的注释问卷进行评估;基线对照评估生成的代码注释,与目前该领域已提出的代码注释生成工具Clocom进行对比评估。经实验表明,本文融合注释复用和程序解析的方法在数量上平均每款软件提高12%,质量上平均每款软件提高5%,而且研究表明绝大多数参与者认为自动生成的注释在帮助他们理解代码时是准确、充分、简洁以及有用的。