Java环境搭建完成后中文乱码问题如何处理

根本原因是源文件编码与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响应头缺失或字符集声明错误,浏览器无法正确解码响应体。

  • 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'},部分老浏览器靠这个推断解码方式
真正卡住人的往往不是“哪里设编码”,而是**同一段代码,在IDE里OK、CMD里炸、浏览器里又变成\u4f60\u597d**——因为每个环节(编辑器保存、javac读取、JVM运行、终端渲染、HTTP传输)都有独立的编码开关,缺一不可。