webstorm中文乱码需同步设置global、project及properties文件三层编码为utf-8，并启用transparent native-to-ascii conversion；终端乱码还需配置jvm参数、系统shell及环境变量；ui字体问题则需手动指定中文字体并重启。
WebStorm 中文乱码不是“没设编码”，而是三层编码策略没对齐——Global、Project、Properties 文件编码必须同步为 UTF-8，且 Transparent native-to-ascii conversion 必须启用，否则 .properties 里的中文会自动转成 \u4f60\u597d 而不提示。
Editor → File Encodings 里三个 UTF-8 必须同时设对
只改 Project Encoding 是最常见错误。这三项缺一不可：
-
Global Encoding：控制新建项目、新文件的默认读取方式（如从 Git clone 下来的文件） -
Project Encoding：决定当前项目下新建文件的保存编码，也参与已有文件的读取 fallback -
Default encoding for properties files：专管.properties文件，不设它，msg=你好就会无声无息变成msg=\u4f60\u597d
全部设为 UTF-8 后，务必勾选 Transparent native-to-ascii conversion ——这是 Java 属性文件中文不被转义的开关。改完点 OK，建议完全退出 WebStorm 再重启，部分设置热加载不可靠。
单个文件乱码？右下角状态栏点开选 Reload 或 Convert
打开乱码文件（比如显示方块或问号），右下角会显示当前识别的编码（如 GBK 或 ISO-8859-1）。点击它弹出列表：
- 直接敲
utf或gbk快速定位编码项 - 选中带 ⚠️ 标记的编码（如
GBK）时，会弹窗问你选Reload还是Convert -
Reload：只让编辑器按新编码重新解析内容，磁盘文件一字不动——适合安全预览 -
Convert：把文件内容按新编码重写进磁盘——必须确认原始内容确实是那个编码，否则中文变问号或方块
一旦执行过 Convert，WebStorm 就会把这个文件和该编码绑定，下次打开不再瞎猜。
Terminal / Run Configuration 输出还是乱码？得动 JVM 和系统层
编辑器里全设成 UTF-8，不代表终端输出就正常。Terminal 输出走的是系统 Shell + JVM 启动参数 + WebStorm 终端渲染三层逻辑：
- Windows：注册表路径
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor新建字符串值Autorun，值为chcp 65001 - macOS/Linux：在 shell 配置文件（如
~/.zshrc）中加export LANG=zh_CN.UTF-8和export LC_ALL=zh_CN.UTF-8 - 所有平台：编辑
bin/webstorm64.vmoptions（Windows/macOS）或bin/webstorm.vmoptions（Linux），末尾追加一行：-Dfile.encoding=UTF-8 - Run Configuration → Environment Variables 里也必须显式设置
file.encoding=UTF-8——IDEA 系列常漏这一层
Project 工具窗口显示口口口？那是字体问题，不是编码问题
左边 Project 栏显示乱码（如 “口口口”），和文件内容编码无关，它只显示文件名和结构。本质是 UI 字体不支持中文字符集：
- 进入
Settings → Appearance & Behavior → System Settings → Fonts - 勾选
Use custom fonts，选一个带中文字体支持的等宽字体（如JetBrains Mono，macOS 可加STHeiti回退，Windows 可加Microsoft YaHei Mono） - 改完必须重启 WebStorm 才生效
真正容易被忽略的是：Quick Documentation（Ctrl + Q）里的 API 注释、终端输出、git 提交信息、Node.js 堆栈错误，这些都不受 IDE 编码设置影响——它们由语言服务、运行时环境或 CLI 工具自身决定。
