Checkstyle工具中ImportOrder与CustomImportOrder规则的差异是什么？

虽然二者都是用来规范Java导入语句的排序，但核心差异体现在灵活性、配置能力以及官方支持状态上：

1. 分组定制能力 #

• ImportOrder：仅支持预设的固定分组（如java.*、javax.*、第三方包、项目内部包），无法自定义新增特殊分组。比如你想把某个特定第三方库（如Guava）单独归为一组，ImportOrder做不到。
• CustomImportOrder：支持完全自定义分组，可通过正则表达式任意定义N个分组，比如把公司公共组件、特定框架包、项目各模块分别设为独立分组，还能精确指定每个分组的排序优先级。

2. 配置复杂度与精细度 #

• ImportOrder：配置极简，只需指定固定分组的顺序，无需正则，适合简单的排序需求。
• CustomImportOrder：配置更灵活但需要一定正则基础，除了分组规则，还能精细控制：
  • 特定分组前后是否添加空行
  • 同组内导入语句是否强制按字母序排列
  • 是否忽略某些特殊导入（如静态导入的单独配置）

3. 官方支持状态 #

ImportOrder已被Checkstyle标记为废弃（deprecated），官方明确推荐使用CustomImportOrder替代——因为后者完全覆盖了ImportOrder的所有功能，同时提供了更强的扩展性。

配置示例对比 #

ImportOrder 基础配置 #

<module name="ImportOrder">
  <property name="groups" value="java,javax,org,com.myproject"/>
  <property name="ordered" value="true"/>
</module>

CustomImportOrder 自定义分组配置 #

<module name="CustomImportOrder">
  <property name="customImportOrderRules" value="
    java\..*,
    javax\..*,
    com\.google\.common\..*,
    org\.springframework\..*,
    com\.mycompany\.common\..*,
    com\.myproject\..*
  "/>
  <property name="separatedByBlankLines" value="true"/>
  <property name="sortImportsInGroupAlphabetically" value="true"/>
</module>

内容的提问来源于stack exchange，提问作者AlexElin