java接口中禁止使用private、protected等非法修饰符，须通过checkstyle插件+自定义illegalmodifierininterface规则实现实时告警与快捷修复。
Java中属性访问修饰符不合规，最典型的就是在接口里声明 private、protected 或包级默认（无修饰符）方法——这直接违反 JLS §9.4，属于编译器本应拦截但有时会漏掉的严重问题。要在 IDE 中实现自动告警，核心是用 CheckStyle 插件 + 自定义规则，而非依赖 IDEA 默认检查。
配置支持自定义规则的 CheckStyle 插件
IDEA 自带的 Inspection 对这类语义级违规识别能力有限，必须引入 CheckStyle：
- 卸载旧版插件（如 v5.x），安装官方最新版 CheckStyle-IDEA v10.19.0+，仅兼容 IDEA 2022.3 及以上版本
- 重启后进入 Settings > Tools > CheckStyle，点击“+”添加配置
- “Location”选 File，路径填
$PROJECT_DIR$/config/checkstyle.xml（务必用变量，避免硬编码相对路径） - 确认右下角状态栏显示 “CheckStyle is enabled”
编写或启用能捕获非法修饰符的规则
标准 CheckStyle 不检查接口方法修饰符合法性，需自定义规则或使用已验证的扩展配置：
- 规则需监听
METHOD_DEF节点，向上追溯父节点是否为INTERFACE_DEF - 提取所有修饰符，明确标记
private、protected、final、native、synchronized为非法（static和default方法内的private工具方法除外） - 推荐复用经实战验证的 rule：如
IllegalModifierInInterface，其log()级别设为ERROR，确保高亮+阻断 - 命令行验证：运行
checkstyle -c config/checkstyle.xml src/main/java/xxx/Service.java确认能报出private void helper()类错误
开启实时扫描并绑定快捷修复
仅靠手动检查无法形成开发闭环，必须让问题在写代码时就暴露：
- 在 CheckStyle 设置页勾选 Scan files on the fly，保存后新写的非法声明立即标红波浪线
- 悬停提示明确显示 “Method in interface must not be declared private/protected/final”
- 光标定位到违规行，按 Alt + Enter，选择 “Remove illegal modifier” 可一键删掉冗余关键字
- 若团队统一要求，可将该规则同步到 Maven 的
maven-checkstyle-plugin，实现 CI 构建硬拦截
不复杂但容易忽略：关键不在装插件，而在规则本身是否真正覆盖 JLS 约束；只要 XML 里那条自定义检查生效，IDEA 就会像盯编译错误一样盯住每一个错放的 private。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
