为何Spotless已配置换行规则却不拆分超长代码行？

代码示例（业务逻辑无关） #

public class Example {
    public void doSomething(List<String> list) {
        try {
            if (doesNotMatter) {
                list.forEach(item -> {
                    // 以下代码行长度超过120字符
                    item.contains("a very very long string") ? doSomethingWithItem(item) : doSomethingElseWithItem(item);
                }
            }
        }
    }
}

问题现象 #

使用Spotless格式化上述文件时，预期会将超过120字符的代码行拆分为多行，但实际并未生效。更糟的是，手动拆分该行后，Spotless会自动将其恢复为单行形式（目前发现可通过在拆分后的第一部分添加空注释//规避此问题）。

核心疑问 #

为什么Spotless会忽略120字符的换行规则？

使用的配置 #

Gradle插件配置（build.gradle） #

plugins {
  id 'com.diffplug.spotless' version '6.25.0'
}

spotless {
  java {
    eclipse().configFile(rootProject.file('codeformat.xml'))
    formatAnnotations()
    trimTrailingWhitespace()
    removeUnusedImports()
    indentWithSpaces(4)
  }
}

代码格式化配置文件（codeformat.xml） #

由IntelliJ代码格式化设置导出，包含以下配置项：

<setting id="org.eclipse.jdt.core.formatter.lineSplit" value="120"/>
<setting id="org.eclipse.jdt.core.formatter.line_length" value="120"/>
<setting id="org.eclipse.jdt.core.formatter.comment.line_length" value="120"/>

问题原因解析 #

1. IntelliJ导出配置的兼容性问题：Spotless的eclipse()格式化器基于Eclipse JDT的规则工作，但IntelliJ导出的XML配置和Eclipse原生配置并不完全等价。你当前的配置只设置了行长度阈值，却缺少三元表达式换行的具体规则——Eclipse JDT不会仅因为行超长就自动拆分三元表达式，必须明确配置相关的换行触发条件。

2. 缺少三元表达式的强制换行规则：默认情况下，Eclipse JDT对三元运算符（?:）的格式化策略是保持单行，除非你在配置中添加以下规则：

<setting id="org.eclipse.jdt.core.formatter.control_statements.ternary_operator.split_before_question" value="true"/>
<setting id="org.eclipse.jdt.core.formatter.control_statements.ternary_operator.split_before_colon" value="true"/>

这两项配置会告诉格式化器，当行长度超过阈值时，在?和:前强制换行。

3. Spotless的规则优先级：Spotless严格遵循你提供的codeformat.xml中的配置，没有明确配置的规则会使用Eclipse JDT的默认值。因为你没指定三元表达式的换行规则，所以即使行超长，Spotless也不会自动拆分，甚至会把手动拆分的代码合并回单行。

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