12.17

注释不应解释“代码在做什么,这应该由清晰的代码本身表达，而应解释“代码为什么这么做”。记录当时的决策背景、背后的业务逻辑、对某个特殊边界条件的处理原因，或者指出一个看似奇怪实为无奈之举的“坑”。