java控制台输出中文乱码本质是编译、运行、终端三者默认编码不一致导致字节错位解码:源文件utf-8 → javac默认用gbk编译 → jvm用utf-8解码gbk字节流 → 控制台显示乱码,必须同步配置files.encoding、compilerargs、vmargs及终端chcp 65001和中文字体。

Java控制台输出中文乱码,本质是编码链路断在哪儿?
不是“VSCode不支持中文”,而是 Java 编译、运行、终端三者默认编码不一致导致字节错位解码。Windows 下最典型路径是:源文件 UTF-8 → javac 默认用系统编码(GBK)编译 → JVM 运行时用 UTF-8 解码 GBK 字节流 → 控制台显示 ?? 或方块。关键环节只有对齐才能闭环。
必须改的三项配置:files.encoding、compilerArgs、vmArgs
缺一不可,漏掉任意一项都可能白配:
-
"files.encoding": "utf8"—— 强制所有文件(包括 .java)以 UTF-8 保存,避免编辑器读取时就错 -
"java.configuration.compilerArgs": ["-encoding", "UTF-8"]—— 告诉javac源码是 UTF-8,别猜 -
"vmArgs": "-Dfile.encoding=UTF-8"(写在.vscode/launch.json的 configuration 里)—— 告诉 JVM 运行时所有字符串、I/O、Scanner 输入都按 UTF-8 处理
注意:vmArgs 必须写在 launch.json 里才对调试生效;如果只用 Code Runner 运行,得去 code-runner.executorMap 中加 "java": "cd $dir && javac -encoding UTF-8 $fileName && java -Dfile.encoding=UTF-8 $fileNameWithoutExt"。
终端输出仍乱码?chcp 65001 不够,还得配字体和 profile
PowerShell 或 CMD 默认代码页是 936(GBK),即使 JVM 输出 UTF-8 字节,终端也按 GBK 渲染,结果还是乱码。光靠 chcp 65001 是临时切换,必须固化进 VSCode 终端配置:
Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。
- 在
settings.json中设置"terminal.integrated.profiles.windows",为 PowerShell/CMD 添加"args": ["-NoExit", "-Command", "chcp 65001"] - 同时指定
"terminal.integrated.defaultProfile.windows": "PowerShell" - 加上
"terminal.integrated.fontFamily": "'Sarasa Mono SC', 'Microsoft YaHei'"—— 没中文字体,UTF-8 字节再对也渲染不出来
别信“改系统区域设置就能一劳永逸”,那会影响其他非 UTF-8 工具(比如某些批处理或旧版工具链),反而引入新问题。
老项目打开就是乱码?别直接改 settings.json
如果打开的是别人传来的 .java 文件,右下角状态栏显示 GBK 或 GB2312,说明文件本身是 GBK 编码。这时强行设 files.encoding: utf8 只会让它更乱:
- 先点击右下角编码标识 → 选“通过编码重新打开” → 尝试
GBK或GB2312 - 确认内容正常后,再点右下角 → 选“以编码保存” → 选
UTF-8 - 最后再统一应用上面三项配置,避免后续新建文件又回退
真正容易被忽略的,是“文件实际编码 ≠ 编辑器声称编码”这个前提。没验证就调配置,等于在错的起点上加速跑。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










