Java企业级后端项目必须全程强制使用UTF-8编码，形成“源码→编译→打包→运行→IO→日志→网络”完整闭环，任何一环脱节都可能导致中文乱码、编译失败或线上异常。
Java 企业级后端项目必须全程强制使用 UTF-8 编码，不能依赖系统默认，也不能只在某一处设置。核心是形成“源码→编译→打包→运行→IO→日志→网络”的完整 UTF-8 闭环，任何一环脱节都可能引发中文乱码、编译失败或线上异常。
源文件与 IDE 编码统一
所有 .java 文件必须以 UTF-8（无 BOM）格式保存。IDE 需同步三处编码设置：
- IntelliJ IDEA：Settings → Editor → File Encodings → Global Encoding、Project Encoding、Default encoding for properties files 全设为 UTF-8，并勾选 “Transparent native-to-ascii conversion”（保障 .properties 中文可读）
- Eclipse：Preferences → General → Workspace → Text file encoding → 选 UTF-8；右键项目 → Properties → Resource → Text file encoding → 同样设为 UTF-8
- 检查存量文件是否真为 UTF-8：Linux/macOS 下用
file -i *.java，Windows 可用 Notepad++ 查看编码菜单，清除 ANSI 或 GBK 残留
构建工具显式声明编码
编译器不会自动继承 IDE 设置，Maven 和 Gradle 必须在配置中硬编码指定：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- Maven（pom.xml）：
<properties><br> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><br> <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding><br></properties>
同时确保maven-compiler-plugin的<encoding>配置也为 UTF-8 - Gradle（build.gradle）：
compileJava.options.encoding = "UTF-8"<br>compileTestJava.options.encoding = "UTF-8"
运行时与 JVM 层强制生效
JVM 启动时未指定编码，String.getBytes()、new String(byte[])、InputStreamReader 等操作将按操作系统默认编码执行，跨平台风险极高：
立即学习“Java免费学习笔记（深入）”；
- Spring Boot 打成 jar 运行：启动命令必须加
-Dfile.encoding=UTF-8，例如：java -Dfile.encoding=UTF-8 -jar app.jar - IDE 运行配置（如 IDEA 的 Run Configuration）需在 VM options 中填入该参数
- Linux/macOS 终端确认 locale 支持 UTF-8：
locale | grep UTF；Windows CMD 可执行chcp 65001
文件读写与网络交互不依赖默认
凡是涉及字节与字符串转换的 API，只要没传 Charset 参数，就是隐患：
- 读写文件：用
Files.readAllLines(path, StandardCharsets.UTF_8)，禁用无参版本 - 字符流：用
new InputStreamReader(in, StandardCharsets.UTF_8)，不用无参构造 - Web 层：Spring Boot 需配置
server.servlet.encoding.force=true和server.servlet.encoding.charset=UTF-8；Servlet 中响应前调用response.setCharacterEncoding("UTF-8") - 日志框架（Logback/Log4j2）：encoder 中明确指定
<charset>UTF-8</charset>
