首页/开发/代码质量与评审速查/评论语气:对事不对人
代码评审64 条

评论语气:对事不对人

评审评论针对代码与问题,不针对作者:用事实、影响与提问推进讨论,避免情绪化表达,保护团队的心理安全感。

  • 说代码不说人:这段逻辑在并发下会读脏数据,而非'你写错了'
  • 先肯定有效部分,再提问题:praise 标签常被低估
  • 疑问代替命令:'这里为什么不复用 X' 往往引出真实约束
  • 少用感叹号与绝对化措辞:语气在文本里会被放大
心理安全感决定评审是否敢说真话:语气是质量工具,不是礼貌装饰。
替换句式把「你总是写错」换成「这段在 X 场景会失败」
提问模板这里不用 X 的考虑是什么,是否存在兼容约束

易错点

  • '这点小事都做不好'式评论:之后没人愿意提异议
  • 过度客气导致问题说不清:模糊的评论同样是伤害

数据来源与参考

  • Google Engineering Practices(评审沟通要点)
  • 《The Fearless Organization》(Amy Edmondson,心理安全感)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌