UTF-8编码设置不生效 切换后仅单次编译有效如何解决

• IDE编码配置分层覆盖：IDEA编码配置分为全局、项目、模块三个独立层级，仅修改全局UTF-8配置会被项目/模块的原有编码配置覆盖，同时properties文件有独立的编码规则，未开启透明转换时会强制用其他编码解析
• 构建链路编码缺失：Maven、Gradle等构建工具默认读取当前操作系统的默认编码作为编译编码，俄文Windows环境默认编码为windows-1251，中文Windows默认是GBK，IDE的编码设置不会同步给构建工具，导致编译阶段按错误编码处理文件
• 文件转码操作错误：之前切换windows-1251再切回UTF-8时，若选择了直接切换编码而非先重载再转换，会导致文件内容被错误转码存储，临时重载时内容显示正常，下次重新读取就会回到乱码状态
• 运行时JVM编码未指定：启动程序时未给JVM传编码参数，运行阶段读取文件会走系统默认编码，和IDE设置的UTF-8不匹配

按以下顺序操作即可解决：

• 全层级修正IDE编码配置
  打开Settings -> Editor -> File Encodings，将Global Encoding、Project Encoding、Default encoding for properties files三个选项全部设置为UTF-8，勾选Transparent native-to-ascii conversion选项；点击配置页的模块列表入口，逐个确认所有模块的编码也为UTF-8，确认后点击Apply保存。
• 给构建工具强制指定UTF-8编码
  Maven项目在pom.xml中添加如下配置，锁定全构建链路编码：

  <properties>
      <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
      <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
      <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
  </properties>
  

  Gradle项目在build.gradle中添加编译编码配置：

  tasks.withType(JavaCompile) {
      options.encoding = 'UTF-8'
  }
  

• 修复已被转码损坏的文件
  打开出现乱码的文件，点击IDEA右下角的当前编码标识，先选择Reload in Another Encoding，在弹出的列表中选择windows-1251重载文件，确认文件内容完全正常无乱码后，再次点击右下角编码标识，选择Convert to UTF-8保存文件。注意不要直接选切换编码，否则会把当前显示的乱码直接写入文件造成不可逆损坏
• 锁定运行时编码
  打开Run -> Edit Configurations，在所有用到的运行/调试模板的VM options参数栏添加-Dfile.encoding=UTF-8，确保JVM运行时也使用UTF-8编码读取文件。
• 清缓存重启验证
  选择菜单栏File -> Invalidate Caches...，勾选清除文件缓存、清除索引选项，点击Invalidate and Restart，IDE重启后重新执行全量编译即可。

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