pmd 的 ruleset.xml 是定义代码检查规则的核心配置文件，需基于官方模板修改，通过 启用规则、 排除路径、 调参，并本地验证生效。
1. 从官方 ruleset 模板开始
别从零手写。去 PMD 官方规则文档 找对应语言（比如 Java）的推荐 ruleset，点击“Download”下载一个标准 XML（如 pmd-java-ruleset.xml）。这是最稳妥的起点。
2. 修改 ruleset.xml 的常见方式
打开 XML 后，你会看到类似这样的结构：
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://pmd.sourceforge.net/ruleset/2.0.0 https://pmd.sourceforge.io/ruleset_2_0_0.xsd">
关键操作有这些：
-
启用规则：用
<rule ref="..."></rule>引入单条规则，或整类规则（如category/java/bestpractices.xml） -
禁用规则：加
language和message属性，或直接删掉对应<rule></rule>行 -
调参：在
<rule></rule>内嵌<properties></properties>，填上规则支持的 property 名（查官方文档确认） -
排除路径：在 ruleset 根节点下加
<exclude-pattern>.*Test\.java$</exclude-pattern>跳过测试类
3. 验证和调试 ruleset 是否生效
别改完就扔进 CI。本地先验证：
- 命令行运行：
pmd -d src/main/java -f text -R ruleset.xml - 如果报错，大概率是 XML 格式错误或规则路径写错（注意大小写、斜杠方向、文件是否存在）
- 加
-debug参数看 PMD 加载了哪些规则，确认你的 rule 是否被识别 - IDEA 或 Eclipse 插件里手动指定这个 ruleset，看实时提示是否符合预期
4. 进阶：模块化与复用
大项目建议拆分：
- 建
ruleset-core.xml（基础必检项） - 建
ruleset-test.xml（仅对 test 目录启用的规则） - 主
ruleset.xml用<rule ref="./ruleset-core.xml"></rule>引入，清晰又易维护
