配置Java项目编码需在IDE、编译、运行三环节统一使用UTF-8；2. IntelliJ IDEA和Eclipse中设置文件编码为UTF-8；3. 编译时通过命令行或Maven/Gradle指定-Encoding UTF-8；4. 处理.properties文件中文需转义或改用XML/JSON；5. 运行时通过-Dfile.encoding=UTF-8确保JVM使用正确编码，避免乱码。
在Java开发过程中，正确设置项目编码格式至关重要，尤其是处理中文字符或跨平台协作时。编码不一致容易导致乱码问题，影响代码编译与运行。以下是配置Java项目编码格式的常用方法，适用于主流开发环境。
设置IDE中的文件编码
大多数Java项目在集成开发环境（IDE）中进行开发，因此需在IDE中统一设置编码格式，推荐使用UTF-8，它是目前最通用的字符编码标准。
- IntelliJ IDEA：进入 File → Settings → Editor → File Encodings，将Global Encoding、Project Encoding 和 Default encoding for properties files 都设置为 UTF-8。
- Eclipse：右键项目 → Properties → Resource → Text file encoding，选择 UTF-8。也可在 Window → Preferences → General → Workspace 中全局设置编码。
- 确保新创建的文件也默认使用 UTF-8，避免个别文件出现编码偏差。
配置编译器编码参数
即使IDE显示正常，若编译时未指定编码，javac 可能使用系统默认编码，引发问题。可在编译时显式指定编码。
- 使用命令行编译时添加 -encoding UTF-8 参数：
javac -encoding UTF-8 MyProgram.java - 在构建工具中配置编码：
-
Maven：在 pom.xml 中加入：
<properties> <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding> </properties>
-
Gradle：在 build.gradle 中添加：
compileJava { options.encoding = 'UTF-8' }
处理属性文件和资源文件编码
.properties 文件默认使用 ISO-8859-1 编码，若包含中文，需转义或改用其他方式。
立即学习“Java免费学习笔记（深入）”；
- 可使用 native2ascii 工具转换中文为 Unicode 转义字符。
- 现代框架如 Spring 支持加载 UTF-8 编码的 properties 文件，需配置 ResourceBundle 或使用
@PropertySource(encoding = "UTF-8")。 - 考虑使用 XML 或 JSON 格式替代 properties 文件，更便于处理多语言文本。
操作系统与环境变量影响
某些系统默认编码非 UTF-8（如Windows的GBK），可能影响运行时行为。
- 启动Java程序时可通过JVM参数指定字符集：
java -Dfile.encoding=UTF-8 MyProgram - 注意：该参数应在所有环境下保持一致，避免测试与生产环境差异。
- 可通过代码验证当前编码：
System.getProperty("file.encoding");
基本上就这些。只要在IDE、编译、运行三个环节统一使用UTF-8，就能有效避免绝大多数编码问题。关键是团队协作时保持配置一致，建议将编码设置写入项目文档或初始化脚本中。
