java项目编码格式的核心是统一使用utf-8，需在源文件、ide、编译器（maven/gradle）、资源文件、jvm启动参数及日志配置等环节同步设置，形成utf-8闭环。
Java项目编码格式的核心是统一使用UTF-8，避免中文乱码、编译失败或IDE行为不一致等问题。关键不在“怎么设”，而在“在哪设、设几处、是否同步”。
源代码文件编码（.java）
这是最基础的一环。Java源文件本身需保存为UTF-8（无BOM），否则中文注释或字符串可能被Javac误读。
- 在IDE中（如IntelliJ IDEA）：File → Settings → Editor → File Encodings → 设置Global Encoding和Project Encoding均为UTF-8，勾选“Transparent native-to-ascii conversion”（对properties文件友好）
- 在Eclipse中：右键项目 → Properties → Resource → Text file encoding → 选择Other → UTF-8
- 若用命令行编译，显式指定编码：
javac -encoding UTF-8 Main.java
编译器与构建工具编码
即使源码是UTF-8，编译器默认可能按系统locale解析，Maven/Gradle也需显式声明。
- Maven：在pom.xml中添加属性：
<project.build.sourceencoding>UTF-8</project.build.sourceencoding>
同时建议加上：<project.reporting.outputencoding>UTF-8</project.reporting.outputencoding> - Gradle（build.gradle）：
compileJava.options.encoding = "UTF-8"compileTestJava.options.encoding = "UTF-8"
资源文件与配置文件编码
.properties文件默认按ISO-8859-1读取，含中文必须转义（如\u4f60\u597d），但更推荐改用UTF-8格式+配套加载方式。
立即学习“Java免费学习笔记（深入）”；
- 保持.properties为UTF-8编码，并用
ResourceBundle.getBundle(..., new UTF8Control())加载（JDK7+） - 或直接改用YAML/JSON/TOML等天然支持UTF-8的配置格式（如Spring Boot推荐application.yml）
- XML、HTML、JSON等文本资源，确保文件保存为UTF-8且声明encoding（如
<?xml version="1.0" encoding="UTF-8"?>）
运行时与控制台输出编码
程序运行时，System.out/printStackTrace可能因终端或JVM默认编码异常显示乱码。
- 启动JVM时加参数：
-Dfile.encoding=UTF-8（推荐写入IDE运行配置或shell脚本） - Linux/macOS终端确认locale为UTF-8：
locale | grep UTF；Windows CMD可执行chcp 65001 - 日志框架（Logback/Log4j2）配置中指定encoder charset：
<encoder><charset>UTF-8</charset>...</encoder>
基本上就这些。重点不是每处都设一遍，而是从源码→编译→打包→运行形成UTF-8闭环。多数乱码问题，根源都在某一处漏掉了编码声明。
