Java项目编码设置与配置教程

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《Java项目编码配置指南》，聊聊，我们一起来看看吧！

Java项目中文乱码源于源文件读取、编译、JVM运行、IDE显示、构建工具五环节编码不统一；需统一设为UTF-8：源码保存为UTF-8无BOM，IDE全局/项目编码设UTF-8，javac加-encoding UTF-8，JVM启动加-Dfile.encoding=UTF-8，构建部署环境同步配置。

Java项目中编码格式配置不当，容易导致中文乱码、编译失败或运行时字符串异常。核心问题不在代码本身，而在于源文件读取、编译器解析、JVM运行、IDE显示、构建工具处理这五个环节的字符集是否统一。默认情况下，JDK 17+ 使用UTF-8，但旧版本（如JDK 8）默认用系统编码（Windows常为GBK），极易出问题。

确保源码文件保存为UTF-8

这是起点。无论IDE如何设置，源文件物理编码必须是UTF-8：

• 在IntelliJ IDEA中：File → Settings → Editor → File Encodings → Global Encoding / Project Encoding / Default encoding for properties files → 全部设为UTF-8；勾选“Transparent native-to-ascii conversion”（对properties文件必要）
• 在Eclipse中：Window → Preferences → General → Workspace → Text file encoding → UTF-8；再进入Java → Compiler → Encoding → 设为UTF-8
• 用记事本或VS Code编辑时，务必手动选择“另存为UTF-8无BOM格式”

显式指定javac编译编码

即使源码是UTF-8，javac仍可能按系统默认编码读取——尤其在命令行编译时：

• 命令行编译：加参数 -encoding UTF-8，例如：javac -encoding UTF-8 Main.java
• Maven项目：在pom.xml中配置maven-compiler-plugin：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-compiler-plugin</artifactId>
  <version>3.11.0</version>
  <configuration>
    <source>17</source>
    <target>17</target>
    <encoding>UTF-8</encoding>
  </configuration>
</plugin>

JVM运行时字符集控制

程序运行阶段，InputStreamReader、Scanner、Files.readString()等API依赖默认字符集，而该默认值由JVM启动时决定：

• 推荐方式：启动JVM时强制指定 -Dfile.encoding=UTF-8，例如：java -Dfile.encoding=UTF-8 MyApp
• 验证当前默认编码：运行 System.out.println(Charset.defaultCharset());
• 避免依赖默认值：读写文件时显式传入Charset，如 Files.readAllLines(path, StandardCharsets.UTF_8)

构建与部署环境一致性

本地正常 ≠ 服务器正常。Linux服务器LANG常为en_US.UTF-8，但若脚本未声明或容器未配置，仍可能降级：

• Maven打包时，确保MAVEN_OPTS含 -Dfile.encoding=UTF-8
• Docker镜像中，在Dockerfile添加：ENV LANG=C.UTF-8 或 ENV JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8
• Spring Boot应用可在application.properties中加：server.servlet.encoding.charset=UTF-8 和 server.servlet.encoding.enabled=true（仅影响HTTP请求体解码）

本篇关于《Java项目编码设置与配置教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！