常见问题排查
定位 YAML、Properties、插件安装和 IDE 兼容性相关的常见问题。
快速排查清单
- 确认插件版本与 IntelliJ IDEA 版本匹配（可到“历史版本”页面核对）。
- 安装完成后重启 IDE，确保索引与文件类型识别生效。
- 确认文件类型：YAML（*.yml/*.yaml）或 Properties（*.properties）。
- 用最小示例配置（如仅 spring.application.name）验证，以排除项目特例导致的问题。
- 如果新项目可用但当前项目不可用，检查 IDE 缓存/索引并尝试重新导入工程。
常见配置错误示例
- YAML 缩进：层级写错会导致配置项被忽略或解析失败。
- 键名拼写错误：一个字母写错就会导致配置不生效。
- profile 覆盖顺序：application-*.yml 可能覆盖基础配置，造成“看起来写了但没生效”。
- 类型不匹配：数字/布尔值被写成字符串（或反之）可能导致绑定异常。
需要进一步帮助？
建议先阅读“文档-安装指南”；如仍不生效，重新下载与 IDE 匹配的插件版本再尝试。也可以通过页脚的 GitHub 链接提交问题反馈。
什么时候应该使用排查清单
- 刚安装插件后 YAML 或 Properties 没有任何补全提示。
- 新项目能补全，但当前项目因为缓存、索引或文件类型识别导致不生效。
- 升级 IntelliJ IDEA 后，原插件版本与 IDE 大版本不匹配。
- 配置项看起来已填写，但运行时没有生效，需要检查 profile 覆盖和键名拼写。