java中配置checkstyle需安装插件、启用检查、加载utf-8无bom的checkstyle.xml（保留charset、注释header模块）、绑定并激活配置，再通过右键扫描或quick fix快速修复违规项。

Java基础开发中配置Checkstyle，核心是让规范检查落地到日常编码环节，而不是仅靠人工Review。重点不在装插件，而在规则能真正生效、提示及时、修复方便。

安装CheckStyle-IDEA插件

打开IntelliJ IDEA → File → Settings → Plugins → 搜索【Checkstyle-IDEA】→ Install → 重启IDEA。重启后进入 Settings → Editor → Inspections → 找到Checkstyle并勾选Enable inspection，否则不会触发实时检查。

准备并加载checkstyle.xml规则文件

在项目根目录新建checkstyle.xml，推荐直接使用Google官方风格（从GitHub地址下载）。注意两点：

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

• 保留<property name="charset" value="UTF-8"></property>，否则中文注释会报错
• 删掉或注释掉<module name="Header"></module>，除非团队强制要求统一文件头

绑定配置并开启实时检查

进入 Settings → Tools → Checkstyle：

• 勾选 “Use the following Checkstyle config file”
• 点击“+”号，浏览并选中项目根目录下的checkstyle.xml
• 在Configuration列表中选中刚添加的配置，务必勾选 “Active”

这一步漏掉，编辑器就不会高亮任何问题；如果配置后无反应，大概率是XML含BOM头或全角符号，用纯文本编辑器重新保存为UTF-8无BOM格式即可。

扫描与快速修复违规项

右键项目模块 → Checkstyle → Check Module，结果在底部Checkstyle窗口展示，双击可跳转定位。对单个文件修复更高效：右键编辑器空白处 → Checkstyle → Quick Fix，自动修正命名、空格、import顺序等常见问题。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南