解决 IntelliJ IDEA 中文乱码的终极方案

大墨同学_6229

大墨同学_6229

2026-08-14

200人浏览

原创

控制台输出中文乱码的根源是jvm未指定utf-8编码,需在run/debug configurations的vm options中添加-dfile.encoding=utf-8(大小写敏感、带短横),并确保file encodings三处均为utf-8且勾选transparent native-to-ascii conversion。

解决 intellij idea 中文乱码的终极方案

控制台输出中文乱码:先看 Run/Debug Configurations 里的 VM options

绝大多数人遇到的“System.out.println("你好") 输出乱码”,根源就在这里。IDEA 启动 JVM 时没告诉它用 UTF-8 解码,JVM 就按系统默认编码(Windows 常是 GBK)去读字节,自然错位。

操作路径:Run → Edit Configurations… → Templates → Application(改模板可一劳永逸),在 VM options 栏填入:-Dfile.encoding=UTF-8。

常见错误:

  • 只改了某个具体 Run Configuration,新创建的 Main 方法又乱码——必须改 Templates → Application
  • 写了 -Dfile.encoding=utf8(少个连字符或大小写错)——必须是 UTF-8,大小写敏感,带短横
  • 没重启已运行的程序——改完要重新 Run,不是仅保存配置

Tomcat 日志乱码:别只动 IDEA,logging.properties 和 catalina.sh/bat 都得同步

外置 Tomcat 的日志乱码,光在 IDEA 的 VM options 里加 -Dfile.encoding=UTF-8 不够。因为 Tomcat 自己的日志处理器(java.util.logging.ConsoleHandler)会忽略 JVM 全局编码,只认自己的配置。

两处必须同时改:

  • TOMCAT_HOME/conf/logging.properties 中,把 java.util.logging.ConsoleHandler.encoding 的值明确设为 UTF-8(不能留空或写 ${...})
  • TOMCAT_HOME/bin/catalina.sh(Linux/macOS)或 catalina.bat(Windows)中,在 JAVA_OPTS 里追加 -Dfile.encoding=UTF-8

注意:如果用的是 IDEA 内嵌 Tomcat(即 “Application server” 选的是 “Local”),那只需改 IDEA 配置里的 VM options,不用碰 Tomcat 安装目录。

文件编辑器和属性文件乱码:File Encodings 三处必须一致,且勾选 Transparent native-to-ascii conversion

代码里中文注释、.properties 文件里的 name=张三 显示为 name=\u5f20\u4e09 或直接方块,说明编辑器读取时解码错了。

Idea Reality Validator
Idea Reality Validator

在写代码前,通过 GitHub、Hacker News、npm、PyPI 和 Product Hunt 检查竞争对手的预建创意验证器。

下载

进 File → Settings → Editor → File Encodings,确认以下三项全为 UTF-8:

  • Global Encoding
  • Project Encoding
  • Default encoding for properties files

最关键的是勾选 Transparent native-to-ascii conversion —— 不勾它,.properties 文件里的中文会被自动转成 \uXXXX 形式保存,下次打开就再也还原不了原始中文。

idea64.exe.vmoptions 是兜底项,但加错位置或漏重启等于白干

当以上都试过还乱码,说明 IDEA 自身启动 JVM 时编码就错了。这时要改 IDEA 的启动参数文件。

路径:IDEA_INSTALL_DIR/bin/idea64.exe.vmoptions(Windows/macOS/Linux 新版统一用这个),在**最后一行**添加:

-Dfile.encoding=UTF-8

注意点:

  • 不能加在中间或注释行里,必须是独立一行
  • 改完必须彻底退出 IDEA(右上角 × 关闭所有窗口,任务栏进程也要杀干净),再重开
  • 如果用的是 JetBrains Toolbox 管理的 IDEA,改的是 Toolbox 下载的那个安装目录下的文件,不是旧版本残留路径

真正容易被忽略的,是 .idea/encodings.xml 这个隐藏文件——它会为单个文件强制指定编码。一旦里面混入了 GBK 或空值,整个项目部分文件就会顽固乱码。删掉它,重启 IDEA,让 IDE 重新按全局设置推导编码。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
剧云AI短剧创作教程合集
剧云AI短剧创作教程合集

本专题聚焦剧云AI短剧创作,讲解从短剧灵感、梗概、全局大纲到分集、分场和正文的完整流程及节奏设计方法。

2026.10.14

0

15

剧云AI剧本创作零基础入门
剧云AI剧本创作零基础入门

本专题系统讲解剧云AI剧本创作流程,涵盖灵感、梗概、大纲、分场与正文生成,帮助新手快速完成首个中文剧本项目。

2026.10.14

0

14

VibeKnow文档转视频操作指南
VibeKnow文档转视频操作指南

本专题讲解VibeKnow上传Word、TXT、Markdown等材料生成视频的方法,覆盖内容解析、脚本组织、画面生成与成片检查。

2026.10.14

0

15

VibeKnow知识视频制作与导出详解
VibeKnow知识视频制作与导出详解

本专题整理VibeKnow从注册、素材上传、AI生成到预览导出的完整操作,帮助新手快速制作第一条知识讲解视频。

2026.10.14

0

13

二狗PPT大纲编辑实操指南
二狗PPT大纲编辑实操指南

本专题聚焦二狗PPT结构化大纲的生成和修改,讲解标题、正文、目录、页数与页面顺序的调整方法,提升汇报逻辑和内容完整性。

2026.10.14

0

15

二狗PPT文档转PPT全教程
二狗PPT文档转PPT全教程

本专题讲解二狗PPT解析Word、PDF、Excel和PPT资料的方法,涵盖文件上传、内容提取、大纲整理、异常处理与转换后校对。

2026.10.14

0

13

讯飞绘文全功能使用教程
讯飞绘文全功能使用教程

本专题系统整理讯飞绘文官网入口、注册登录、工作台及内容创作流程,帮助用户熟悉常用功能,快速完成首篇图文内容。

2026.10.14

0

14

讯飞绘文AI写作与文案生成合集
讯飞绘文AI写作与文案生成合集

本专题聚焦讯飞绘文AI写作、提纲生成、文章改写和文案润色,覆盖从主题输入到成稿优化的关键操作与实用技巧。

2026.10.14

0

14

PixTV官网入口地址合集
PixTV官网入口地址合集

本专题汇总了 PixTV AI 一站式视频创作平台的官方入口与使用教程。无需下载软件,浏览器直接访问即可使用。平台将剧本、图像、视频、声音与剪辑整合在“无限画布”中,接入 GPT Image 2.5、Seedance 2.5 等头部模型。本专题整理了从新建画布、角色锚定、分镜拆分到视频生成与导出的完整操作指南,助你快速上手 AI 短剧与漫剧创作。

2026.10.10

100

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程