IDEA中Project Encoding与File Encoding必须统一设为UTF-8，否则新建文件仍为GBK、老文件读取乱码；需同步配置Global/Project/Properties编码、启用Transparent转换，并规范Maven、Git及Eclipse相关设置。
IDEA里project encoding和file encoding必须一致
很多人改了File Encoding却没同步改Project Encoding，结果新建文件还是GBK，老文件读取又乱码。IntelliJ默认用系统编码（Windows常为GBK），但Java源码必须是UTF-8——否则String.getBytes()行为不一致，Maven编译可能报unmappable character错误。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 打开
Settings → Editor → File Encodings，把Global Encoding、Project Encoding、Default encoding for properties files全设为UTF-8 - 勾选
Transparent native-to-ascii conversion（尤其对messages_zh_CN.properties这类含中文的资源文件必需） - 已有乱码文件别直接“Reload as UTF-8”，先用记事本另存为UTF-8无BOM，再在IDEA里
File → Reload project from disk
Eclipse用户要关掉“Save resources when switching editors”
Eclipse默认在切编辑器时自动保存，而它的编码检测逻辑有坑：如果文件磁盘内容是UTF-8但未声明编码（比如没charset=UTF-8在@WebServlet或HTTP头里），它可能按平台默认编码重写一次，悄悄引入BOM或乱码。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 关闭
Preferences → General → Editors → Save automatically when editor loses focus - 手动设置每个项目右键 →
Properties → Resource → Text file encoding → Other → UTF-8 - 检查
.settings/org.eclipse.core.resources.prefs里是否含encoding=UTF-8，没有就补上
Maven编译乱码？重点看compiler-plugin的encoding参数
IDE编码设对了，Maven命令行编译仍报错，大概率是maven-compiler-plugin没指定编码。它默认用file.encoding系统属性，而该属性在CI环境（如Jenkins）里常为空或ISO-8859-1。
当用户提及 GitHub URL，或要求分析、审查、探索或理解任意 GitHub 项目、仓库或代码库时，请使用此技能。触发条件包括以下短语：“分析这个项目”、“看看这个仓库”、“analyze this repo”、“what does this project do”，或消息中包含任何 github.com URL。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 在
pom.xml中显式配置插件：
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.11.0</version>
<configuration>
<source>17</source>
<target>17</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>- 同时确保
MAVEN_OPTS环境变量含-Dfile.encoding=UTF-8，避免被CI脚本覆盖 - 验证方式：运行
mvn help:effective-pom | grep encoding，确认输出里有<encoding>UTF-8</encoding>
Git提交前务必检查.gitattributes是否禁用CRLF转换
Windows换行符CR+LF混入UTF-8文件，会导致某些解析器（如Spring Boot的@PropertySource）读取失败；更隐蔽的是，Git在checkout时自动转CRLF，再commit又转回LF，看似没变，实际SHA-1已不同——团队协作时频繁提示“modified: xxx.java”，本质是行尾+编码双重干扰。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 项目根目录加
.gitattributes，内容只留一行：* text=auto eol=lf - 执行
git rm --cached -r . && git reset --hard重建索引（注意备份未commit更改） - IDEA用户额外勾选
Settings → Editor → Code Style → Line separator → Unix and macOS (\n)
最容易被忽略的是：即使所有设置都对，旧项目迁移时git config core.autocrlf若为true，仍会偷偷转换。统一设为false，把换行控制权完全交给.gitattributes。
