根本原因是源文件编码与javac默认读取编码不一致;JDK 17+默认UTF-8,旧版JDK在Windows默认GBK,而编辑器多存为UTF-8,导致编译乱码或报错。

Java编译时出现中文注释或字符串显示为问号或方块
根本原因是源文件编码与javac默认读取编码不一致。JDK 17+ 默认使用UTF-8,但Windows系统上旧版JDK(如8、11)仍默认用系统编码(如GBK),而多数编辑器(VS Code、IDEA)新建文件默认存为UTF-8,导致编译时报错或运行时乱码。
- 检查源文件真实编码:用Notepad++或VS Code右下角查看,确认是
UTF-8而非UTF-8 with BOM(BOM可能引发javac解析失败) - 强制指定编译编码:
javac -encoding UTF-8 Hello.java
- 若用Maven,需在
pom.xml中配置:UTF-8
Java程序运行时控制台输出中文为乱码(Windows CMD/PowerShell)
这是终端自身不支持UTF-8或未正确切换编码所致,和Java代码无关。JDK本身已能正常输出UTF-8字节,但CMD默认用GBK解码,造成“字对码错”。
- 临时修复CMD:运行
chcp 65001(切换为UTF-8代码页),再执行java Hello - PowerShell需额外设置:
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
,否则即使chcp 65001也无效 - 更彻底的方案:改用Windows Terminal,并将默认配置设为
"fontFace": "Consolas"(支持UTF-8且含中文字体) - 避免依赖终端:用
java Hello > output.txt重定向到文件,再用记事本(UTF-8)打开,可验证程序本身输出是否正确
IDEA或Eclipse里中文正常,但命令行运行仍乱码
说明IDE已自动加了-Dfile.encoding=UTF-8等参数,而你手动运行时没带——这是最常被忽略的断层。
- 查看IDEA实际运行命令:右上角运行配置 → Modify options → 勾选
Show command line afterwards,运行后就能看到完整java -Dfile.encoding=UTF-8 ... - 手动补全JVM参数:
java -Dfile.encoding=UTF-8 Hello
- Eclipse同理:Run → Run Configurations → Arguments → VM arguments 输入
-Dfile.encoding=UTF-8 - 注意:
-Dfile.encoding影响String.getBytes()、new FileReader()等API,默认值由系统决定,不设就可能用GBK
Web应用(Spring Boot/Tomcat)返回JSON含中文变Unicode转义或乱码
不是文件编码问题,而是HTTP响应头缺失或字符集声明错误,浏览器无法正确解码响应体。
立即学习“Java免费学习笔记(深入)”;
- Spring Boot 2.3+ 默认已设
Content-Type: application/json;charset=UTF-8,但如果手动用了@ResponseBody+String返回,需显式设置:response.setCharacterEncoding("UTF-8"); response.setContentType("application/json;charset=UTF-8"); - Tomcat 9+ 默认使用UTF-8,但若用
server.xml自定义Connector,必须加URIEncoding="UTF-8",否则GET参数中文会乱码 -
前端fetch/AJAX请求时,别漏掉
headers: {'Accept': 'application/json;charset=UTF-8'},部分老浏览器靠这个推断解码方式










