写好注释的几条原则：
- 假设读者的语言水平跟你一样，比如说，不要去解释“什么是字符串，也别去解释什么是赋值语句”。
- 不要注释那些显而易见的事情，比如下面这条注释是毫无意义的：
count=count+1 //add one to count - 在代码中写上一些以”TODO”或”FIXME”开始的注释，目的是为了提醒之后回来编写或清理一些未解决的问题。
- 如果你在编写某段程序时需要使劲思考的话，那么就应该编写注释，以便别人不会再在这个地方绞尽脑汁。尤其要注意的是，如果你在开发程序或函数时使用要点来进行描述，尽量将这些要点写细一些，在开发工作完成之后，还应该将原来的要点全部保留下来直接当做注释。
- 如果有个bug很难查明，或者其修改方案比较复杂，那么你就应该编写一条注释来对其进行解释。如果不这么做，那么今后其他负责该部分代码的程序员就可能认为它没必要这么复杂并将其改回原来的模样，从而让你的心血付诸东流。
- 如果需要大量注释才能解释清楚某段代码的作用，那么就应该对这些代码进行整理。比如说，如果需要分别对一个函数中的15个列表进行解释，那么就应该将该函数拆分成更小的代码块，每一个分别只处理较少的几个列表。
- 过时的注释还不如没有注释。因此，在修改了某段代码之后，一定要仔细检查相关注释，并对其做出适当的修改以保证其仍能准确描述代码功能。
- 不用解释代码怎么做（即how，这应该从代码结构本身容易看出），而要去解释为什么这样做（即why，即算法过程、原理）。
- 养成良好的命名规范并形成一种团队间默认的命名约定，这样看到变量名或函数名，团队中其他成员就知道它是干什么的，形成一种代码的自注释。
- 记住一点，编程是思路的一种表达，程序写给人看的（计算机只接受并处理二进制串），因此，编程不仅仅在于完成功能的开发，更多的是代码的可维护性，所以必须借助注释形成清晰的逻辑思路的表达。