于无声处

原创 我们怎样写注释

代码注释，就是用大白话告诉别人（或者三个月以后的自己），我写的这些计算机程序，它到底想干嘛。除去某些特殊场合，这些大白话通常都用程序员的母语来写，这样可以表达得更清楚——当然方言例外，不是所有的人都知道什么叫“抵拢倒拐”——但是无论这些白话有多白，它总是不可避免会给别人带来很多困扰。首先，很多人（包括我自己）不喜欢在写代码的同时写注释，虽然在读别人代码时常会因为注释太少而恨得牙痒痒。这种己所不