核心是确保字符编码在“读—处理—写”全链路一致,需统一utf-8、显式指定字符集(如standardcharsets.utf_8)、避开filereader/filewriter等默认编码陷阱,并同步配置ide、maven、终端及web请求响应的编码声明。

Java 基础中处理中文乱码,核心是**确保字符编码在“读—处理—写”全链路一致**,尤其要避开默认编码陷阱。Java 内部用 UTF-16 表示字符串,但与外部交互(文件、控制台、网络)时必须显式指定字节与字符的转换规则,否则极易因平台默认编码(如 Windows 的 GBK、Linux/macOS 的 UTF-8)或历史协议(如 HTTP 默认 ISO-8859-1)导致乱码。
源文件与编译环节:统一 .java 文件编码
IDE 默认用系统编码打开 .java 文件,若源码含中文注释或字符串,而文件实际保存为 UTF-8,但 IDE 以 GBK 解析,就会编译出错或运行时显示乱码。
- 在 Eclipse/IntelliJ 中:全局设工作空间编码为 UTF-8(Window → Preferences → General → Workspace → Text file encoding)
- 对单个项目:右键项目 → Properties → Resource → Text file encoding → 选 Other → UTF-8
- Maven 项目需在 pom.xml 显式声明:
UTF-8 - 避免用 Windows 记事本保存 Java 源文件——它默认加 BOM,可能引发编译异常;推荐用 VS Code 或 Notepad++ 并另存为“UTF-8 无 BOM”
文件读写:绝不使用 FileReader / FileWriter
FileReader 和 FileWriter 隐式依赖系统默认编码,完全不可控。必须用 InputStreamReader + FileInputStream 组合,并明确传入 StandardCharsets.UTF_8。
Java项目代码review工具。分析Git变更+完整调用链路上下文,推断业务需求,进行多维度评分和分类汇总,生成完整PRD文档。包含细粒度Java代码审查清单(Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 正确读取:new BufferedReader(new InputStreamReader(new FileInputStream("a.txt"), StandardCharsets.UTF_8))
- 正确写入:new BufferedWriter(new OutputStreamWriter(new FileOutputStream("b.txt"), StandardCharsets.UTF_8))
- 若读取的是 GBK 编码旧文件,把 StandardCharsets.UTF_8 换成 Charset.forName("GBK") 即可,但建议先转为 UTF-8 存储
控制台输出:注意终端本身的编码支持
System.out.println("你好") 能否正常显示,不仅取决于 Java 字符串编码,还取决于终端(CMD、Terminal、IDE Console)能否渲染 UTF-8 字节。
- Windows CMD 默认不支持 UTF-8:执行 chcp 65001 切换到 UTF-8 模式,再运行 Java 程序
- IntelliJ 控制台:Settings → Editor → Color Scheme → Console Font → 勾选 “Use color scheme font” 并确保字体支持中文(如 Microsoft YaHei、Fira Code Nerd Font)
- Linux/macOS 终端一般原生支持 UTF-8,无需额外设置
网络与 Servlet 场景:请求/响应双向声明
Web 开发中最易踩坑:浏览器发 UTF-8 数据,服务器却用 ISO-8859-1 解析;或服务器返回未声明 charset,浏览器按错误编码渲染。
- POST 请求前:在 Servlet 中第一行调用 request.setCharacterEncoding("UTF-8")(仅对 body 生效,且必须在 getParameter() 前)
- 响应输出前:调用 response.setContentType("text/html;charset=UTF-8") 或 response.setCharacterEncoding("UTF-8")
- JSP 页面顶部加:
- GET 请求参数乱码无法靠 setCharacterEncoding 修复,需手动转码:new String(request.getParameter("name").getBytes("ISO-8859-1"), "UTF-8")
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










