Checkstyle插件没红线提示，主因是未指定checkstyle.jar绝对路径、未配置checkstyle.xml完整路径、Java环境未识别；需填checkstyle-10.12.3-all.jar和alibaba-java-checkstyle.xml的绝对路径，确认enabled="true"及XML嵌套正确，并重启VSCode。
装完插件没反应，不是插件坏了，是 Checkstyle 这条链路根本没通——它不自带引擎，只负责把 .java 文件扔给 checkstyle.jar 去跑，而 VSCode 默认连 jar 都找不到。
Checkstyle 插件为什么没红线、没提示
核心问题就三个：没指定 checkstyle.jar 路径、没指向正确的 checkstyle.xml、Java 环境没认全。插件本身不报错，只是静默跳过检查。
- VSCode 设置里搜
checkstyle.executable，必须填checkstyle-10.12.3-all.jar的**绝对路径**（带-all后缀，否则缺依赖） -
checkstyle.configuration填的不是“规则名”，而是alibaba-java-checkstyle.xml的**完整路径**，推荐用${workspaceFolder}/checkstyle.xml - 确保已配置
java.home（Java Extension Pack 会提示设置），否则插件连 JDK 版本都读不到，直接放弃扫描 - 改完设置后必须重启 VSCode，手动按
Ctrl+Shift+P→ 输入CheckStyle: Run Check触发一次，看控制台有没有输出结果
alibaba-java-checkstyle.xml 里哪些规则其实没开
阿里规范里大量条款标的是「建议」，比如「方法参数不超过 5 个」，对应 ParameterNumber 规则，默认是关的，XML 里 enabled="false" 就等于不存在。
- 打开你的
checkstyle.xml，全局搜索ParameterNumber，确认enabled="true" - 它的默认
max是 7，要改成 5 得显式写：<property name="max" value="5"/> - 类似还有
MethodLength、LineLength，它们的阈值都在value属性里，不是maxLength或maxLineLength - 别信网上抄来的旧版 XML——JDK 17+ 项目必须用 Checkstyle 10.x + 新版阿里规则文件，否则
record、sealed语法直接抛ParseError
VSCode 里看到 Unable to parse configuration 怎么办
这个错误几乎全是 XML 语法或属性名写错导致的，不是路径问题。Checkstyle 解析失败时不会告诉你哪一行错，只会卡在顶层。
立即学习“Java免费学习笔记（深入）”；
- 常见错误：把
ignoreOverridden写成ignoreOverride（老版本不认）、allowMissingJavadoc拼错成allowMissJavadoc - 所有规则必须挂在
<module name="Checker">下，且TreeWalker只能有一层；多套一层<module name="TreeWalker">，里面规则全失效 - 用命令行快速验证：
java -jar checkstyle-10.12.3-all.jar -c /path/to/checkstyle.xml YourClass.java，报错位置比 VSCode 清晰得多 - 路径含中文或空格？立刻改掉。VSCode 和 Checkstyle 都对这类路径处理不稳定
最易被忽略的一点：VSCode 插件不校验 checkstyle.xml 里的模块嵌套逻辑，它只管转发。所以 XML 里少个 </module> 或错位嵌套，VSCode 不报错，但检查永远不生效——得靠命令行或 Maven 侧反向验证。
