为何调整Java导入语句顺序会导致编译失败？

我之前一直笃定Java导入语句的顺序完全不影响代码语义——毕竟不管是IntelliJ IDEA、Eclipse这类主流编辑器，都自带一键整理、优化导入的功能；像Checkstyle、PMD这类代码风格检查工具，甚至会强制要求按「标准库→第三方库→本地包」或者字母序来排序导入。而且之前搜遍了各类技术资料，确实很少看到有人提到调整导入顺序会有风险，我也一直把这当成毫无成本的安全操作。

直到最近，我实打实碰到了一个坑：只是调整了导入语句的顺序，原本能正常编译的代码直接报错了！

后来排查发现，问题出在类名冲突+通配符导入的组合场景里。举个具体例子：我同时导入了import com.example.util.*;和import java.util.*;，而这两个包下恰好都有一个Result类。之前的导入顺序是先显式导入了com.example.util.Result;，再导入java.util.*;，编译器能明确识别代码中Result的指向；但整理导入时，工具把通配符导入移到了显式导入前面，虽然显式导入还在，但某些旧版本的构建工具（比如老版Maven Compiler插件）在解析时，居然优先匹配了通配符里的同名类，导致代码里的方法调用全部报错。

除此之外，还有可能碰到这类例外场景：

• 某些自定义注解处理器对导入语句的顺序敏感，扫描导入的顺序变化会导致注解处理逻辑出错
• 极个别老旧Java编译器对静态导入和普通导入的顺序解析存在bug

所以说，虽然导入语句重排在绝大多数情况下都是安全的，但绝对不能掉以轻心：

• 整理导入后一定要做一次编译验证，尤其是大型项目或依赖复杂的项目
• 对于存在同名类的场景，尽量使用显式导入而非通配符导入，从根源避免冲突
• 如果碰到编译失败，优先检查是否有类名/成员名冲突，或者导入顺序是否影响了编译器的类解析逻辑

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