关于 JAVA 源代码生成 API 的编码问题

Posted 2023-04-04

今天做JAVA API文档的时候由于源代码的编码问题导致一直无法生成API，想请问JAVA对API文档的格式编码有什么要求吗？我用的UTF-8无BOM格式编码就无法成功生成API，还想请问WINDOWS环境下有什么可以查看文档默认编码的方法吗？

这个视乎源文件的编码，
另外，javadoc有参数
-charset <charset> 用于跨平台查看生成的文档的字符集。

Notepad++可以查看源文件的字符集。。。。Eclipse 里面的文件属性，也能看到追问

但是我用notepad++查看书中的源代码的时候上面没有编码显示！所以我才想问怎么查看的。

而且我的意思是使用utf-8无bom的格式的时候都无法编译通过，也无法生成api文档

追答

Notepad++显示在右下的状态栏。。。。。

javadoc -encoding utf-8 -charset utf-8

参考技术A 执行javadoc的时候指定字符集-encoding UTF-8 -charset UTF-8
http://blog.csdn.net/wqjsir/article/details/5691254追问

就是javadoc命令必须是utf-8的编码格式才能成功生成api文档吗？

追答

跟你的java文件用的编码保持一致就行了

java 生成javadoc文档，怎么总报错

参考技术A 用eclipse导出工程的doc文档，发生编码 GBK 的不可映射字符的错误，这是由于java源代码文件为utf-8编码，源代码中的doc注释喊中文。生成文档时就可能会出现该错误。解决方法：
Export后进入javadoc Generate 时， 点“next”进入第三个对话框时，在"Extra Javadoc options" 文本框里面加上 “-encoding UTF-8 -charset UTF-8”，如图：

2.出现“非法字符：\65279”的解决方法
一般用UE或记事本编辑过的UTF-8的文件头会加入BOM标识，该标识由3个char组成。在UTF－8的标准里该BOM标识是可有可无的,Sun 的javac 在编译带有BOM的UTF-8的格式的文件时会出现“非法字符：\65279”的错误。
用UE等打开该java源文件，另存为无BOM的utf-8格式。
3.如果没报任何错误但是不显示注释 则和1.的解决办法一样本回答被提问者和网友采纳