IntelliJ将文件名转为小写致构建失败，求根源与永久修复方案

克隆Maven项目后，初始src目录结构：

src
  |-main
    |- java
       |-com.controller
         |- CommonController.java

构建项目时，文件名自动变为小写，目录结构异常：

src
  |-main
    |- java
       |-com.controller
         |-commoncontroller.java
            |- CommonController

IntelliJ抛出错误：
java: class CommonController is public, should be declared in a file named CommonController.java

多个项目均出现该问题，同事无此异常，怀疑是IntelliJ本地设置导致。

1. 开启文件大小写敏感性 #

IntelliJ默认在Windows系统下关闭大小写敏感性，会导致文件大小写处理混乱：

• 打开IntelliJ，进入File > Settings > Appearance & Behavior > System Settings
• 找到FileSystem板块，勾选Case-sensitive names选项
• 重启IntelliJ后重新构建项目

2. 检查Git全局配置 #

本地Git的大小写忽略设置可能导致文件同步异常：

• 打开终端，执行命令查看当前设置：git config --global core.ignorecase
• 若输出为true，执行命令修改：git config --global core.ignorecase false
• 删除本地项目，重新克隆后测试

3. 清理IntelliJ缓存 #

缓存损坏可能引发异常行为：

• 进入File > Invalidate Caches...
• 选择Invalidate and Restart，等待IDE重启并重新导入项目

4. 排查第三方插件 #

第三方插件可能篡改文件结构：

• 进入File > Settings > Plugins
• 禁用所有非官方插件，重启IDE后测试
• 若恢复正常，逐个启用插件排查问题插件并卸载

5. 重置IntelliJ默认设置（终极方案） #

若以上方法均无效，重置IDE到初始状态：

• 关闭IntelliJ
• 删除IDE配置目录：
  • Windows：C:\Users\<你的用户名>\.IntelliJIdea<版本号>下的config和system文件夹
  • Mac：~/Library/Application Support/JetBrains/IntelliJIdea<版本号>下的config和system文件夹
  • Linux：~/.IntelliJIdea<版本号>下的config和system文件夹
• 重新打开IntelliJ，导入项目测试

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