java平台默认编码不可全局修改，正确做法是显式声明编码：jvm启动加-dfile.encoding=utf-8或设java_tool_options；编译阶段用-javac -encoding utf-8或maven/gradle配置；代码中禁用无参getbytes()等api，改用standardcharsets.utf_8；ide需统一global/project/properties编码为utf-8。
Java 中平台默认编码不能也不该被“全局修改”，正确做法是主动规避依赖，通过显式声明和统一配置来消除不确定性。
明确 JVM 启动时的默认编码
JVM 启动后，Charset.defaultCharset() 和 System.getProperty("file.encoding") 的值就已确定，它由启动参数 -Dfile.encoding 决定。不设该参数时，JVM 会读取操作系统区域设置（如 Windows 的 GBK、Linux 的 UTF-8），导致跨环境行为不一致。
- 强制指定为 UTF-8：启动命令加
-Dfile.encoding=UTF-8，例如java -Dfile.encoding=UTF-8 -jar app.jar - 对所有子进程生效（含 Maven、测试等）：设环境变量
JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF-8"（比-D更优先） - 验证是否生效：运行
System.out.println(Charset.defaultCharset());，输出应为UTF-8
编译阶段避免隐式使用系统编码
即使源文件保存为 UTF-8，javac 默认仍按系统编码读取内容。Windows 上若用 GBK 解析含中文的 UTF-8 源码，会直接报错或生成错误字节码。
- Maven 项目：在
maven-compiler-plugin中配置<encoding>UTF-8</encoding> - Gradle 项目：设置
compileJava.options.encoding = "UTF-8" - 命令行编译：显式传参
javac -encoding UTF-8 *.java
代码中杜绝无参字符转换 API
String.getBytes() 和 new String(byte[]) 这类无参重载方法，完全依赖当前 JVM 的默认编码，是乱码高发点。
- 替换为带
StandardCharsets.UTF_8的版本：str.getBytes(StandardCharsets.UTF_8) - 文件 I/O 必须显式传参：
Files.readAllLines(path, StandardCharsets.UTF_8)、new InputStreamReader(in, StandardCharsets.UTF_8) - 网络传输同理：HTTP 请求体、JSON 序列化、Socket 发送等场景，编码必须写死或可配置，不可省略
IDE 和文件层面保持三统一
IDE 编码设置、文件实际保存编码、项目配置三者不一致，是团队协作中最常见的乱码根源。
- IntelliJ IDEA：Settings → Editor → File Encodings → 把 Global/Project/Properties 三项全设为 UTF-8；右下角点击编码提示，选 “Convert to UTF-8” 并勾选 “Transparent native-to-ascii conversion”
- Eclipse：Preferences → General → Workspace → Text file encoding → 选 UTF-8
- 检查已有文件真实编码：Linux/macOS 用
file -i *.java，Windows 可用 Notepad++ 查看编码菜单，避免残留 BOM 或 ANSI
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
