checkstyle能将代码规范检查左移到编码阶段，通过安装插件、配置checkstyle.xml文件（支持现成/定制/复用三种方式）、绑定配置并启用实时检查，实现保存前自动提示违规项，配合扫描与quick fix快速修复可自动化问题。
在Java项目开发中，团队成员提交的代码命名混乱、import顺序随意、方法过长却没人及时指出，导致Code Review时反复争论格式问题而忽略逻辑缺陷。这种低效协作会拖慢交付节奏，而CheckStyle能将规范检查左移到编码阶段，让问题在保存前就暴露出来。
安装CheckStyle-IDEA插件
打开IntelliJ IDEA → File → Settings → Plugins → 在搜索框输入 【Checkstyle-IDEA】 → 点击Install → 安装完成后重启IDEA。
重启后若未自动启用，需手动进入Settings → Editor → Inspections → 找到Checkstyle并勾选Enable inspection。
配置项目专属规则文件
方法一：使用现成配置快速启动
在项目根目录新建 【checkstyle.xml】 文件，粘贴Google Java Style官方规则（可从 https://github.com/checkstyle/checkstyle/blob/main/src/main/resources/google_checks.xml 直接下载）。
方法二：从零定制关键规则
编辑 checkstyle.xml 时，务必保留 <property name="charset" value="UTF-8"></property>，否则中文注释会被误判为非法字符；删除或注释掉 <module name="Header"></module> 模块，除非项目强制要求统一文件头版权信息。
方法三：复用团队已有配置
直接将团队共享的 checkstyle.xml 拷贝至项目根目录，确保路径中不含中文或空格，否则IDEA可能加载失败。
绑定配置并启用实时检查
第一步：进入 Settings → Tools → Checkstyle
第二步：勾选 “Use the following Checkstyle config file” → 点击右侧“+”号 → 浏览并选中项目根目录下的 checkstyle.xml → 点击OK
第三步：在Configuration列表中选中刚添加的配置 → 勾选 “Active” → 点击Apply
这一步必须完成，否则编辑器不会高亮任何违规项；如果配置后仍无反应，检查XML文件是否语法错误——常见坑是复制时多出不可见的BOM头或全角符号。
执行扫描与修复违规代码
右键点击项目模块 → Checkstyle → Check Module，等待扫描完成。
扫描结果会出现在底部Checkstyle工具窗口，双击某条违规记录可直接跳转到对应代码行。
对单个文件快速修复：右键编辑器空白处 → Checkstyle → Quick Fix，IDEA会自动修正命名、空格、import排序等可自动化问题。
注意：【MethodLength、ParameterNumber等涉及逻辑拆分的规则不会自动修复】，必须人工重构，工具仅提示位置和阈值。
