新代码质量评审标准与评分表格

前面发了一个《代码质量评审标准与评分表格》，是比较宽泛的，下面发一个更贴近具体场景的《新代码质量评审标准与评分表格》。

一、引言
本文档旨在为代码质量评审提供一个统一的标准和评分机制，以确保代码质量、可读性和可维护性。通过遵循这些标准和进行评分，我们可以提高开发团队的协作效率，减少潜在问题，并促进代码的持续改进。
二、评审目的与原则
目的：确保代码质量符合项目需求，提高代码的可读性、可维护性和可扩展性。
原则：公正、客观、具体、建设性。

三、 评审标准
1 代码提交（30%）
• 按时提交:约定每周四，周五16：00前提交代码；
• 提交前自测：在提交代码之前，确保代码能够成功编译并运行，没有明显的语法错 误或逻辑错误。
• 提交信息清晰：编写有意义的提交信息，简要说明此次提交的内容和目的，包括修复了哪些问题、新增了哪些功能等。
• 避免大规模改动：尽量将改动拆分成多个小提交，每个提交只包含一个逻辑变更，这有助于评审者理解每次变更的目的。
• 测试覆盖：确保新增或修改的代码有相应的测试用例覆盖，以提高代码质量。
• 文档更新：如果代码变动影响了用户文档或API文档，确保及时更新相关文档。
2 注释和文档完整性（30%）

• 文件注释：通常在文件的开头部分，用于描述整个文件的目的、创建日期、作者、依赖项、修改历史等。要求包含但不限于文件的目的，作者，日期三项。
• 类注释：
用于描述类的目的、功能、属性、方法、依赖关系等；要求包含但不限于类的目的，作者&#