为什么写java代码的注释这么纠结！！！

为什么写java代码的注释这么纠结！！！是我语文水平太差？英语水平太差？？
不是不想写注释，可是发现要写好的注释真不容易！

解决方案 »

  1.   

    core java的作者建议写一个方法之前先把它的javadoc注释写出来。如果不好写的话，重新考虑方法
      

  2.   

    如果是用IDE的话，比如Eclipse，可以在 windows - perferences - java - Code Style 里面定制注释啊。
      

  3.   


    可以参考JDK源码的注释。还可以利用Eclipse里面javadoc view的功能很方便的查看自己写的javadoc。
      

  4.   

    在《走出软件作坊》一书里作者就提到，他曾经接手一个维护项目的工作，一个方法2500行代码，没有注释(作者在发表本书的时候是CTO，不光精于技术，更善长业务与管理，与客户打交道等)，以他的水平说了一句：这代码我是一行都不敢动。什么重构、什么高深的技术此时都显得如此乏力，注释对后期维护的重要性，就在你弹指键盘间啊！！！
      

  5.   

    我觉得java的注释还不错啊~！！~