idea中搜不到apidoc插件是因为其未上架官方市场，实际可用的是apidocx（对接rap2）和apifox helper（对接apifox）；需换关键词搜索，旧版idea需手动下载.zip包安装；注释风格须匹配工具链，配置文件路径与字段名严格区分大小写且无空格；上传仅限当前打开文件，不支持增量更新。
插件安装失败常见原因和绕过方法
IDEA 里搜不到 apidoc 插件，基本不是网络问题，而是插件本身未上架 JetBrains 官方市场——它没有独立的 IDEA 插件包，所谓「APIDoc 插件」实际是误传。真正能用的只有两类工具：Apidocx（对接 RAP2）、Apifox Helper（对接 Apifox），二者都不叫「APIDoc」。
如果你在插件市场搜 apidoc 无结果，别折腾代理或重装 IDE，直接换关键词搜：apidocx 或 apifox。旧版 IDEA（如 2018.x）对插件签名验证更严，即使搜到也大概率报 plugin xxx is incompatible 错误——此时必须去 JetBrains 插件官网 手动下载对应 IDEA 版本的 .zip 包，解压后放入 plugins/ 目录重启。
注释写法必须匹配工具链，不能混用
apidoc 命令行工具（npm 安装）和 IDEA 插件不是一回事：前者解析的是 @api 开头的注释块，后者只认 Spring MVC 注解 + Javadoc 或特定字段提取。比如 Apidocx 依赖 @api 标签，而 Apifox Helper 实际靠解析 @ApiOperation、@ApiParam 等 Swagger 注解生成文档。
-
@api {GET} /user/:id 获取用户信息这类写法只对apidocCLI 和Apidocx有效，对Apifox Helper完全无效 -
@ApiOperation("获取用户信息")这类 Swagger 注解才是Apifox Helper的输入源，且要求项目已引入springfox-swagger2或springdoc-openapi - 混写两种风格（比如在 Swagger 注解旁再加
@api）会导致解析冲突或字段丢失
配置文件路径和字段名大小写敏感
Apidocx 要求项目根目录存在 .yapi 文件，不是 .apidoc 也不是 yapi.properties；Apifox Helper 则完全不读该文件，它只从 IDEA 设置页填入 Project ID 和 API Token。
.yapi 文件内容必须严格按如下格式（等号前后不能有空格，字段名全小写）：
rap2ProjectId=42 xyapiProjectId= eolinkerProjectId= showdocProjectId= returnWrapType=
其中 rap2ProjectId 是唯一必填项，值为 RAP2 后台项目页 URL 最后一截数字；其他字段留空即可。填错大小写（如 RAP2ProjectId）或加空格（如 rap2ProjectId = 42）会导致上传时静默失败，控制台无报错。
上传动作触发时机和范围限制
右键菜单里的「Upload to Apifox」或「上传文档」不是全局扫描，它只处理当前打开的 Java 文件（通常是 @RestController 类），不会递归扫描整个 src/main/java。如果 Controller 分散在多个包下，必须逐个文件右键操作。
另外，Apidocx 默认只上传带 @api 注释的函数，Apifox Helper 默认只上传带 @ApiOperation 的方法——没加对应标签的方法会被跳过，不会报错也不会提示。调试时建议先删掉部分注释做最小验证，确认流程通了再补全。
真正容易被忽略的是：所有插件都不支持增量更新。每次上传都是全量覆盖，旧接口若在代码中被删但没重新上传，Apifox 或 RAP2 上仍会残留。必须手动清理或配合 CI 脚本定期重推。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
