Java项目在Eclipse中需三处统一设为UTF-8：项目级Text file encoding（右键项目→Properties→Resource）、工作空间全局编码（Window→Preferences→Workspace）、Maven的project.build.sourceEncoding；否则中文注释、文件读写、编译均可能乱码。
Java项目在Eclipse里默认编码不是UTF-8，中文注释或文件读写常乱码——必须手动改，且要改三处，缺一不可。
项目级别的Text file encoding设置
这是最常被忽略的一处。Eclipse默认用系统编码（Windows是GBK），导致.java文件保存时就把中文转成乱码字节。
- 右键项目 → Properties → Resource → 找到
Text file encoding - 选中
Other→ 输入UTF-8（不要选Default (inherited from container)） - 勾选
Override encoding from Workspace，否则会被工作空间设置覆盖 - 点
Apply and Close，然后右键项目 →Refresh，再打开.java文件确认中文是否正常显示
工作空间（Workspace）全局编码配置
新创建的项目会继承工作空间编码，不设好，下一个项目还得重配。
- 菜单栏 → Window → Preferences → General → Workspace
- 修改
Text file encoding为UTF-8 - 注意：改完不会自动刷新已有项目，只影响新建项目和未显式覆盖编码的旧项目
- 如果团队共用同一工作空间（比如IDE共享配置），这里必须统一，否则协作时.gitattributes都救不了
编译器源码字符集（Source Encoding）与Maven兼容性
即使文件存成UTF-8，javac若没被告知源码编码，仍可能按平台默认解码，报unmappable character错误。
立即学习“Java免费学习笔记（深入）”；
- Eclipse内置编译器默认读取
Text file encoding，所以前两步做完通常够用 - 但若项目用Maven构建（
pom.xml中含maven-compiler-plugin），必须额外指定：UTF-8 - 否则命令行执行
mvn compile时会失败，而Eclipse里却正常——这种差异极易引发“本地能跑，CI挂了”的问题
真正麻烦的是混合场景：项目从SVN检出（历史编码是GBK）、又含第三方jar包内嵌非UTF-8资源、还调用new String(byte[], charset)硬编码了ISO-8859-1……这时候光调Eclipse设置没用，得逐层检查字节流源头。编码问题从来不是单点配置能根治的，而是整个I/O链路的契约一致性问题。
