17370845950

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中添加属性：
  UTF-8
  同时建议加上：
  UTF-8
• Gradle（build.gradle）：
  compileJava.options.encoding = "UTF-8"
compileTestJava.options.encoding = "UTF-8"

资源文件与配置文件编码

.properties文件默认按ISO-8859-1读取，含中文必须转义（如\u4f60\u597d），但更推荐改用UTF-8格式+配套加载方式。

• 保持.properties为UTF-8编码，并用ResourceBundle.getBundle(..., new UTF8Control())加载（JDK7+）
• 或直接改用YAML/JSON/TOML等天然支持UTF-8的配置格式（如Spring Boot推荐application.yml）
• XML、HTML、JSON等文本资源，确保文件保存为UTF-8且声明encoding（如）

运行时与控制台输出编码

程序运行时，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：
  UTF-8...

基本上就这些。重点不是每处都设一遍，而是从源码→编译→打包→运行形成UTF-8闭环。多数乱码问题，根源都在某一处漏掉了编码声明。