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免费学习笔记（深入）”；
- 启动命令必须加参数：
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
