如何配置JavaDoc使其支持///行注释而非/** … */块注释？

原生JavaDoc不支持直接将///格式的行注释识别为文档注释，它只默认解析/** ... */格式的块注释。但你可以通过以下几种方式绕开这个限制：

• 预处理脚本转换
  写一个简单的脚本，先把代码里的///行注释批量转换成标准的JavaDoc块注释，再运行javadoc命令。比如用Shell的sed工具可以快速实现：

  # 将连续的///行合并为单个JavaDoc块注释
  sed -e '/^\/\//{:a;N;/\n\/\//!s/\n/ /;ta;s/^\/\/\/ /** /;s/$/ */}' YourJavaClass.java > ProcessedJavaClass.java
  

  这个脚本会把连续的///行拼接成一行，再替换成/** ... */的格式，处理后的文件就能正常被JavaDoc解析了。

• IDE插件/自定义模板辅助
  在IntelliJ IDEA、Eclipse这类IDE里，可以通过自定义Live Template或者安装第三方插件，让你用///的方式编写注释，后台自动转换成标准JavaDoc格式。比如在IDEA里创建Live Template，输入///后自动展开为/** */块注释，同时允许你按行编写内容，最终生成符合规范的文档注释。

• 自定义Doclet解析
  如果有开发能力，可以自己编写JavaDoc的Doclet扩展，重写注释解析逻辑，让它直接识别///行注释作为文档注释。这种方式需要熟悉JavaDoc的Doclet API，继承StandardDoclet并修改注释读取的相关逻辑，成本较高，但能完全适配你的需求。

需要注意的是，不管用哪种方法，JavaDoc的标签（比如@param、@return）还是要遵循原有规范，只是注释的开头格式做了转换。

内容的提问来源于stack exchange，提问作者Bolpat