代码评论规范指南
各维度得分依据公开资料与字段推算,加权后即综合评分,仅供参考。
Conventional Comments是一个面向各类评审反馈场景的开源结构化评论格式规范，项目托管于conventionalcomments.org，核心目标是解决线上协作评审中评论模糊、语气误解、信息不全导致的沟通内耗问题，通过统一的标签化格式让评论意图更清晰，同时支持机器自动解析。
该规范定义了清晰的评论格式框架：<label> [decorations]: <subject> [discussion>，其中标签(label)是核心分类，预定义了praise(表扬)、nitpick(细节偏好)、suggestion(改进建议)、issue(问题)、todo(待办)、question(疑问)、thought(想法)、chore(例行任务)、note(备注)9种核心标签，同时支持自定义扩展；装饰(decoration)为可选附加信息，比如标注non-blocking(非阻塞)或分类如security(安全)、ux(用户体验)；主题是评论核心内容，讨论部分补充背景、推理和下一步建议。
这套规范适配代码评审、同行评审、文档修订、RFC讨论等多种协作场景，标签化格式不仅能让接收者快速读懂评论意图，还可以被机器自动解析为结构化数据，方便集成到各类开发工具中。
Conventional Comments作为开放规范完全免费，无任何付费门槛。它的优势非常明确：规则简单易上手，统一格式有效减少了因为文字语气产生的误解，能帮团队节省大量沟通成本，同时结构化特性支持工具自动化处理，灵活性高允许团队自定义标签适配自身需求。缺点在于它仅提供规范标准，没有原生配套的协作工具，需要团队自行将规范集成到现有GitHub、GitLab等工作流中，对于已经形成固定沟通习惯的团队需要一定适应成本，当前抓取到的官方文档也存在内容不完整的问题。
它适合需要高频开展代码评审、文档协作、技术讨论的开发团队或内容团队引入，尤其是长期开展远程协作的团队。中国访问状态无法从现有抓取内容确认。
本测评基于公开资料整理,不构成购买建议,请以 conventionalcomments.org 官网实际信息为准。
开源式协作规范，对开发团队有参考价值。
评分明细(分布与用户短评)接入中。当前展示 TG4G 综合评分,数据源自公开测评与用户反馈。