注意事项：

右键项目 -> Export -> Java -> JavaDoc -> 选定Public表示录入所有的源文件,其他的可想而知    按步骤走下去最后Finish时，一般是不会报什么错的。

而我实属特例啊！   原因在于搞的是坑爹的JEECMS二次开发，上几位大神级别的人物居然不注重源文件的编码！ UTF-8/GBK   这尼玛的把我可害惨咯。

下面就我制作文档这一路遇到的问题说下：

1. 编码错误

E:\eclipse-j2ee\workspace\sporthome\src\cn\facekee\cms\action\front\CMSAction.java:22: 编码 GBK 的不可映射字符
 * 鍙厤缃紝鑷姪鏁版嵁鍧楃鐞?
                   ^

2. 坑爹的错误

E:\eclipse-j2ee\workspace\sporthome\src\cn\facekee\cms\action\front\CMSAction.java:1: 需要为 class、interface 或 enum
锘縫ackage cn.facekee.cms.action.front;

就这两个错误，在我这就是因为字符编码导致的。 建议：

1. 保证你的工程没有错误

2. 整个工程的源文件的字符编码都是一致的

3. 注意自己采用的注释 “规范” (标签使用错误会导致警告，而且降低文档的可读性)

写博客不仅是一种习惯，更是一种沉淀。