Spring Boot 配置补全不生效的排查清单
按插件状态、版本匹配、文件类型、最小项目和缓存索引逐项排查补全问题。
当 IntelliJ IDEA 中 YAML 或 Properties 补全不出现时，按插件状态、文件类型、索引和项目配置逐项排查。
先判断是插件问题还是项目问题
补全不生效时，第一步不是重装插件，而是区分问题范围。新建一个最小 Spring Boot 项目，如果在新项目中补全正常，说明插件基本可用，问题更可能来自当前项目的文件类型识别、索引缓存或项目导入状态。
如果新项目也完全没有补全，才优先检查插件是否启用、版本是否匹配、IDE 是否重启过，以及安装包是否来自正确的历史版本。
推荐排查顺序
按顺序排查能避免无效操作。尤其是团队环境里，不同成员的 IDEA 大版本、JDK、Maven/Gradle 配置可能不同，先确认本地基础条件，再看项目层问题。
- 确认插件已安装且处于 Enabled 状态
- 确认插件版本匹配当前 IntelliJ IDEA 大版本
- 安装或升级后重启 IDE
- 确认文件类型是 YAML、YML 或 Properties
- 用最小 Spring Boot 项目验证补全
- 对现有项目尝试重新导入或 Invalidate Caches
什么时候需要换插件版本
如果 IntelliJ IDEA 升级到了新的大版本，而原插件是在旧平台 API 上构建的，可能出现安装成功但功能异常的情况。此时优先到历史版本页寻找匹配版本，而不是清空整个 IDE 配置。
版本不匹配的典型表现包括：安装后功能入口缺失、打开配置文件无任何补全、IDE 日志中出现插件兼容性警告。
相关文章
本站由 ErickPang 独立维护，与 Spring、JetBrains 或 Broadcom 无官方关联。