根本原因是jvm默认编码(windows常为gbk)与utf-8字节流不匹配,需在jvm启动前通过-dfile.encoding=utf-8统一编码,并配合chcp 65001、源文件utf-8无bom及ide重启等措施协同生效。

电脑运行Java程序时控制台输出中文变成问号、方块或乱码字符,根本不是代码写错了,而是JVM启动时默认用系统旧编码(Windows上常为GBK/936)去解释UTF-8字节流,导致字节与字符映射错位。必须在JVM加载类前就锁定编码行为,否则System.out.println("你好")永远显示为???。
命令行直接运行jar包或class文件
第一步:打开CMD(不要用PowerShell,chcp在PowerShell中常被忽略),输入chcp 65001并回车→确认提示“活动代码页:65001”出现。
第二步:执行java命令时必须显式带参数,例如:java -Dfile.encoding=UTF-8 -jar myapp.jar。漏掉-Dfile.encoding=UTF-8这串,chcp 65001就白设了——JVM仍按老编码读取控制台句柄。
第三步:验证是否生效,加一行测试代码:System.out.println(System.getProperty("file.encoding"));。如果输出是UTF-8,说明参数已起效;若仍是GBK或空值,说明参数未被JVM接收,检查是否写错成-Dfile.encoding=utf8(大小写敏感,必须全小写UTF-8)。
IntelliJ IDEA中运行Java程序
方法一:改全局VM选项(推荐,一劳永逸)
Help → Edit Custom VM Options → 在打开的文件末尾新增一行:-Dfile.encoding=UTF-8 → 保存后必须重启IDEA,否则控制台管道缓存不会刷新。
方法二:只改当前项目运行配置
右键.java文件 → Run 'XXX.main()' → 点击右上角下拉箭头 → Edit Configurations → 在VM options框里填入-Dfile.encoding=UTF-8 → Apply → OK。这一步不用重启IDEA,但每次新建配置都要重填。
Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。
注意:仅设置File Encodings里的三处UTF-8(Global/Project/Properties)是不够的,那些只管源码读取,不管System.out输出。
确保源文件本身是UTF-8无BOM
用VS Code打开.java文件,右下角看编码标识,点击后选“Save with Encoding” → “UTF-8”。若显示“UTF-8 with BOM”,必须转成“UTF-8”——BOM头会让javac误读首字符,报错“非法字符:'\uFFFD'”。
用Notepad++打开 → 菜单栏“编码” → 确认是“UTF-8无BOM格式”,不是“UTF-8”(后者可能含BOM)。这一步不完成,编译阶段就可能失败,后续所有运行设置都无效。
临时绕过JVM参数的硬编码方案
在main方法最开头插入这两行:
System.setOut(new PrintStream(System.out, true, "UTF-8"));
这会强制标准输出流以UTF-8编码写入字节,跳过JVM的file.encoding判断。但仅限调试用,上线项目必须走正规-D参数路径。
注意:System.setOut必须在任何System.out.println之前调用,否则第一行输出已按默认编码刷出,无法挽回。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










