java多语言项目必须全链路强制utf-8：源码保存、javac编译（-encoding utf-8）、maven/gradle配置、ide三处编码同步（含无bom的properties）、jvm启动（-dfile.encoding=utf-8）、i/o操作显式指定standardcharsets.utf_8，resourcebundle需转义或改用xml格式。

Java多语言国际化项目中统一字符编码标准，核心是确保所有环节都强制使用UTF-8，从源码、编译、运行到I/O操作，不能依赖系统默认值。乱码不是偶然问题，而是编码链上任一环节脱节的必然结果。

编译阶段：强制javac识别UTF-8

即使.java文件本身是UTF-8保存的，javac默认仍按操作系统编码读取——Windows上常为GBK，会导致中文字符串字面量编译失败或生成错误字节码。

• 命令行编译必须加参数：javac -encoding UTF-8 *.java
• Maven项目在pom.xml中配置编译插件：

  <plugin><groupid>org.apache.maven.plugins</groupid><artifactid>maven-compiler-plugin</artifactid><configuration><encoding>UTF-8</encoding></configuration></plugin>

• Gradle项目在build.gradle中设置：compileJava.options.encoding = "UTF-8"

资源文件与IDE：三处UTF-8必须同步

.properties资源文件（如messages_zh_CN.properties）若含中文，必须保存为无BOM的UTF-8；同时IDE的全局、项目、properties文件三类编码设置也必须一致，否则编辑时看似正常，实际保存已损坏。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• IntelliJ IDEA：Settings → Editor → File Encodings → 全部设为UTF-8（尤其注意“Default encoding for properties files”）
• Eclipse：Preferences → General → Workspace → Text file encoding → 选Other: UTF-8，并勾选“Always use encoding specified in the file”
• 检查已有文件真实编码：Linux/macOS用file -i filename.properties，Windows可用Notepad++查看编码菜单

运行时与I/O：拒绝默认编码，显式指定

JVM启动时未指定编码，System.getProperty("file.encoding")将继承操作系统值（Windows常为GBK，Linux多为UTF-8），导致String.getBytes()、new String(byte[])等行为不一致。

• 启动命令必须加参数：java -Dfile.encoding=UTF-8 -jar app.jar
• 读写文件时不用无参API：
  ✅ 正确：Files.readAllLines(path, StandardCharsets.UTF_8)
  ❌ 错误：Files.readAllLines(path)
• 字符流转换必须传参：
  ✅ 正确：new InputStreamReader(in, StandardCharsets.UTF_8)
  ❌ 错误：new InputStreamReader(in)
• Servlet响应需提前设置：response.setCharacterEncoding("UTF-8")（必须在getWriter()之前）

国际化资源加载：避免Locale与编码耦合

ResourceBundle加载.properties文件时，Java内部会用ISO-8859-1解码——这是历史限制。因此，中文不能直接写在文件里，必须用Unicode转义（如\u767B\u5F55），或改用.xml格式资源（支持UTF-8原生）。

• 推荐做法：用native2ascii工具将UTF-8源文件转为转义格式，或借助IDE自动转换功能
• 更现代方案：使用ListResourceBundle子类或XML格式资源包（ResourceBundle.Control可自定义加载逻辑）
• Spring Boot用户可启用spring.messages.encoding=UTF-8并配合ReloadableResourceBundleMessageSource，它原生支持UTF-8 .properties

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南