在IntelliJ IDEA中为Java项目生成中文API文档需三步：先补全标准Javadoc注释，再通过Tools→Generate JavaDoc配置模块范围、输出路径、zh_CN本地化及三项UTF-8编码参数，最后验证index.html无乱码并发布到/docs目录。
在IntelliJ IDEA中为Java项目快速生成可读、可用、无乱码的API文档，是交付代码前必须完成的关键动作——没有它，协作者打开源码第一眼看到的只是方法签名和空注释，调试时得反复跳转阅读逻辑。
确认源码已写好标准Javadoc注释
打开任意一个待生成文档的Java类，检查其类声明上方是否有以/**开头、*/结尾的块注释；方法上方也需有同类结构，且包含@param、@return等标签。若只有//单行注释或空白，生成的HTML里将只显示“未提供说明”。
IDEA支持快捷补全：把光标停在方法名上→按 Alt+Enter →选“Add Javadoc”，自动插入带占位符的模板。这一步不能跳过，否则生成的文档全是空格和默认提示。
配置并执行一键生成
第一步：点击顶部菜单栏 Tools → Generate JavaDoc
立即学习“Java免费学习笔记（深入）”；
第二步：在弹出窗口中设置关键项：
• Scope：推荐选中具体模块（Module），避免因项目含测试代码或第三方依赖导致生成失败
• Output directory：点击右侧文件夹图标，新建并选择 docs/javadoc 子目录（不要用桌面或根目录，路径含中文或空格会触发javadoc工具报错）
• Locale：填 zh_CN，确保导航栏、页脚等框架文字为中文
• Other command line arguments：粘贴以下内容（缺一不可）：-encoding UTF-8 -charset UTF-8 -docencoding UTF-8 -windowtitle "我的API文档"
第三步：勾选 Include JDK standard doc（可选），若需跳转查看java.util.List等原生类说明，再填入链接：-link https://docs.oracle.com/en/java/javase/21/docs/api/
使用3×3×10框架生成90+个个性化Instagram内容创意，用AI编辑器精选最佳创意，并将获胜者扩展为可操作的简洁内容。
点击 OK，等待右下角状态栏显示“JavaDoc generation completed”。生成过程通常耗时3～30秒，取决于代码量和机器性能。
验证与修复中文乱码
打开输出目录中的 index.html，用Chrome或Edge直接双击打开。
若页面标题、左侧包列表、方法描述出现方框或问号：说明编码参数未生效。此时必须返回上一步，在 Other command line arguments 中确认三项UTF-8参数完整且无拼写错误——【-encoding、-charset、-docencoding三者缺一不可】，少一个就会导致某一层级的中文变乱码。
若浏览器地址栏显示 file:/// 开头且内容正常，说明成功；若提示“无法加载本地文件”，换用IDEA内置浏览器（右键index.html → Open in Browser → Default Browser）即可绕过安全限制。
自动生成后立即发布到项目根目录
方法一：在IDEA中右键刚生成的 docs/javadoc 文件夹 → Reveal in Finder（macOS）或 Open in Explorer（Windows），拖拽整个文件夹到团队共享网盘或Git仓库的 /docs 目录下。
方法二：用终端进入项目根目录，执行：cp -r docs/javadoc ./docs/api && echo "文档已就位"
方法三：在IDEA底部点击 Terminal 标签页，输入：open docs/javadoc/index.html（macOS）或 start docs\javadoc\index.html（Windows），直接唤起浏览器预览最终效果。
