首页/开发/代码质量与评审速查/非阻塞评论:标出不修也能合
代码评审64 条

非阻塞评论:标出不修也能合

用 non-blocking 或 nit 明确标注非阻塞意见:改动可以带着这些小建议合并,作者后续处理,减少为细节反复往返。

  • 适用:可读性建议、可选优化、未来改进点
  • 写法:nit: / non-blocking / optional 前置标签
  • 与阻塞项分开罗列:回复中先列必须改的,再列可选的
  • 作者处理:能顺手改就改,不能则开任务
明确非阻塞能救活大量卡在细节上的 PR。
标签含义nit 可改可不改;non-blocking 不阻塞合并
跟进方式作者不处理时简述理由,评审者不再追问

易错点

  • 标了非阻塞却持续追问:变相阻塞,作者无所适从
  • 把所有意见都标非阻塞:真正的阻塞问题被淹没

数据来源与参考

  • Google Engineering Practices(Nit 惯例)
  • Conventional Comments(non-blocking 修饰词)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌