IDEA配置javadoc

### 配置 IntelliJ IDEA 以生成和显示 Java 项目的 Javadoc

#### 设置 Javadoc 生成参数
为了在 IntelliJ IDEA 中配置 Javadoc 的生成，需遵循特定的步骤来确保所有必要的参数被正确设定。通过访问菜单栏中的 `Tools` -> `Generate JavaDoc...`, 可打开用于指定各种选项对话框[^1]。

在此界面中可以定义输出路径、选择要包含的包以及自定义其他高级属性如可见性级别等。对于希望更精细控制的情况，还可以编辑命令行参数，在此输入框内添加额外的 `-tag` 参数或其他支持的标记以便扩展默认功能集。

#### 调整代码样式以优化 Javadoc 注释布局
当涉及到去除方法注释之后不必要的空白行时，则应前往 `File | Settings`(Windows/Linux) 或者 `IntelliJ IDEA | Preferences`(macOS)，导航至 `Editor > Code Style > Java` 页面并找到 `JavaDoc` 子项下的相应设置开关将其关闭即可实现目标效果[^2]。

/**
 * 这是一个示例类展示如何编写合适的 Javadoc 注释。
 */
public class Example {
    /**
     * 主函数入口点。
     *
     * @param args 命令行传入参数列表
     */
    public static void main(String[] args){
        System.out.println("Hello, world!");
    }
}

#### 使用插件增强体验
除了内置工具外，社区还提供了多种第三方插件可以帮助开发者更好地管理和查看项目内的 API 文档。例如，“Documentation Viewer” 插件允许用户快速预览 HTML 版本的帮助文件而无需离开当前工作区；还有 “CodeGlance”，它能在侧边栏提供折叠式的概览视图方便浏览大型源码库的同时也适用于查找关联说明文字的位置关系[^3]。