根本原因是IDEA存在全局、项目、文件三层编码配置且优先级不同，仅设Project Encoding不生效；需同步统一三项编码、右下角手动转码、pom.xml声明、Maven资源插件指定UTF-8。
IDEA里改项目编码为什么File Encoding设了还不生效
根本原因不是没设置，而是IDEA有三层编码配置：全局默认、项目级别、文件级别，优先级从低到高。只改File Encoding面板里的Project Encoding，不等于所有地方都按这个走。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 打开
Settings > Editor > File Encodings，确认三项一致：Global Encoding（一般用UTF-8）、Project Encoding（必须设为UTF-8）、Default encoding for properties files（也设成UTF-8，否则.properties中文会乱码） - 检查右下角状态栏——如果某个文件右下角显示
GBK或ISO-8859-1，点击它手动转成UTF-8，并勾选Convert（否则只是“假装”切换，内容没重解码） -
pom.xml里加UTF-8
Eclipse中Text file encoding改完仍报unmappable character
这个错误本质是Javac在编译时发现源文件里有当前编码无法表示的字符。Eclipse界面设了编码，但JDK本身没同步告知，尤其Windows默认用GBK，而Java 8+的javac默认按UTF-8解析——两边对不上就炸。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 进
Preferences > General > Workspace，把Text file encoding设为Other > UTF-8 - 进
Preferences > Java > Compiler > JDK Compliance，确认Compiler compliance level和你项目JDK版本一致（比如用JDK 17就别设成1.8） - 最关键的一步：右键项目 →
Properties > Resource→ 检查Text file encoding是否为Inherited from container；如果不是，手动改成Other > UTF-8 - 如果还报错，打开出问题的
.java文件，用记事本另存为UTF-8 with BOM格式再覆盖回去（临时绕过BOM识别bug）
命令行编译Java源码时error: unmappable character怎么破
IDE没参与，完全是javac行为。它默认使用sun.jnu.encoding（系统区域设置）读源码，而不是file.encoding。Windows CMD默认是GBK，Linux终端可能是UTF-8，但javac不一定跟着走。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 强制指定编码：用
javac -encoding UTF-8 MyClass.java，这是最直接可靠的方案 - 避免依赖环境变量：不要指望
set JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8能生效——javac不读这个 - 检查终端真实编码：Windows上运行
chcp看当前代码页（如936 = GBK），Linux/macOS运行locale | grep charset；若非UTF-8，要么改终端，要么必须加-encoding - Gradle用户注意：
compileJava.options.encoding = "UTF-8"必须显式写进build.gradle，否则即使IDE设了也没用
Spring Boot项目启动时报Invalid byte 1 of 1-byte UTF-8 sequence
这通常不是Java源码问题，而是配置文件（application.yml或application.properties）被错误地以非UTF-8方式保存或读取。YAML对空白和编码极其敏感，BOM头或混合编码会导致解析器直接崩溃。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 用VS Code或Notepad++打开
application.yml，确认右下角显示UTF-8且无BOM；如有BOM，用Notepad++的编码 > 转为UTF-8无BOM格式 - 检查
src/main/resources目录下是否有隐藏的.DS_Store或Thumbs.db——某些旧版Spring Boot会尝试加载所有文件，遇到二进制文件就抛这个错 - 如果用了
@PropertySource加载自定义.properties，必须显式指定编码：@PropertySource(encoding = "UTF-8", value = "classpath:my.conf") - Maven资源过滤开启时（
true resources插件配置了UTF-8
真正麻烦的从来不是“怎么设”，而是“谁在什么时候用什么编码读了哪个文件”。IDE、构建工具、JVM、操作系统终端、文本编辑器——五层编码视角稍有错位，乱码就藏在最意想不到的地方。
