Java环境搭建后如何配置默认编码UTF8_Java编码规范说明_网络技术

发布时间 - 2025-12-31 00:00:00 点击率：次

Java编译时默认编码非UTF-8，Windows下为GBK，需显式加-encoding UTF-8参数；IDE需统一设置文件编码为UTF-8并重启；运行时应设-Dfile.encoding=UTF-8且终端需支持UTF-8，三者必须一致。

Java源文件若含中文，javac 编译时默认使用系统编码（Windows 是 GBK），而 IDE 或运行时环境常设为 UTF-8，导致编译后字节码中字符串字面量解码错位。典型表现是控制台输出中文为问号或方块，或 String.getBytes() 结果异常。

这是最直接、最可控的方式，适用于所有 Java 版本（5+）且无需修改系统配置。

javac -encoding UTF-8 Main.java

若项目含多个文件，推荐用通配符并确保路径不含空格或特殊字符：

javac -encoding UTF-8 src/*.java

IDE 自动设置可能被项目级配置覆盖，尤其从 Git 拉取的旧项目常保留 .idea/misc.xml 或 .settings/org.eclipse.core.resources.prefs 中的编码声明。

IntelliJ：File → Settings → Editor → File Encodings → Global Encoding / Project Encoding / Default encoding for properties files → 全部设为 UTF-8
Eclipse：Preferences → General → Workspace → Text file encoding → 选 Other: UTF-8；再进 Preferences → Java → Compiler → Encoding → 确保勾选 “Use default encoding…” 或手动设为 UTF-8
关键点：改完后需重启 IDE，且已有文件右下角编码标识可能仍显示旧值，需点击切换并“Reload”或“Convert”

编译正确 ≠ 输出正确。终端（CMD/PowerShell/Terminal）本身编码、JVM 启动参数、以及 PrintStream 底层实现都会干扰中文显示。

Windows CMD 默认是 CP936（GBK），即使 Java 输出 UTF-8 字节，CMD 也按 GBK 解码——此时应改终端编码：chcp 65001，或改用支持 UTF-8 的终端（如 Windows Terminal）
JVM 启动时建议加：java -Dfile.encoding=UTF-8 MyApp，它影响 new String(byte[])、Files.readString() 等 API 的默认行为
读写文件时别依赖默认编码：显式传参更安全，例如 Files.readString(path, StandardCharsets.UTF_8)

真正容易被忽略的是：**编译、运行、终端三者编码必须链路一致**。少一个环节设错，中文就可能在某个环节被二次转码，这种问题往往在跨平台部署或 CI 流水线里才暴露，而本地开发时恰好“碰巧”能显示。