Java 1.8下IntelliJ IDEA生成Javadoc因--source-path报错求解

核心解决方案：替换为Java 8兼容的命令行参数 #

Java 8的javadoc工具仅支持单短横线的-sourcepath参数，而IDEA 2022.2默认生成的是双短横线的--source-path（这是Java 9+的参数格式），直接修改命令行参数即可解决：

1. 打开Javadoc生成窗口：点击菜单栏的Tools -> Generate JavaDoc...
2. 在弹出的配置窗口中，滚动到底部的「Command line arguments」输入框
3. 找到自动生成的--source-path参数，将其替换为-sourcepath（注意是单短横线，参数名连写）
4. 额外检查：如果配置中包含--release参数（Java 9+支持），也需要替换为Java 8兼容的-source 1.8 -target 1.8

验证配置示例 #

修改后的命令行参数类似：

-sourcepath $ModuleSourcePath$ -source 1.8 -target 1.8 -d $OutputDirectory$ -encoding UTF-8

这样配置后，IDEA会调用Java 8兼容的javadoc命令，不会再出现无效参数的报错，同时无需手动枚举源文件，依然可以通过自定义作用域指定要生成Javadoc的文件范围。

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