WebStorm中文乱码根本原因是Global、Project、Properties三层编码未全部设为UTF-8，且未勾选Transparent native-to-ascii conversion、未手动Convert已有文件；仅改Project Encoding无效，因读取时fallback链依赖三者一致。
WebStorm 项目编码不统一，根本不是“没设 UTF-8”，而是 Global、Project、Properties 三层编码必须全部显式设为 UTF-8，且需配合 Transparent native-to-ascii conversion 和手动 Convert 已有文件 —— 少一个环节，中文就乱。
为什么改了 Project Encoding 还是乱码
只在 Settings > Editor > File Encodings 里把 Project Encoding 改成 UTF-8，几乎必然失败。因为 WebStorm 读取文件时有 fallback 链：先看文件自身 BOM 或 <meta charset>，没有则用 Project Encoding，项目不存在时才退到 Global Encoding。所以：
-
Global Encoding必须设为UTF-8（控制新建项目、新文件的默认读取方式） -
Project Encoding必须设为UTF-8（控制当前项目下新建文件的保存编码） -
Default encoding for properties files必须设为UTF-8（否则.properties中的msg=你好会被自动转成msg=\u4f60\u597d） - 必须勾选
Transparent native-to-ascii conversion（这是 .properties 文件中文不被转义的硬开关）
已有文件怎么批量转 UTF-8 而不炸掉
改完全局设置，不会自动重写旧文件 —— 它们仍保持原编码（如 GBK）。直接编辑可能显示方块或问号。正确做法是：
- 在 Project 工具窗口中，右键点击你要处理的目录（如
src/、config/），不要选node_modules/或vendor/ - 选
Convert Files to UTF-8（注意不是Set File Encoding） - 弹窗中务必勾选
Convert encoding of file content -
Source encoding必须选对（比如原文件是 GBK，就选GBK；不确定可先用Reload预览） - 确认后执行 —— WebStorm 会按源编码读取内容，再以 UTF-8 写回磁盘
Terminal 和 Run Configuration 输出还是乱码
编辑器里全设对了，终端打印中文仍是方块？那是 JVM 和系统层没同步：
- Windows：注册表
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor下新增字符串值Autorun，值为chcp 65001 - macOS/Linux：编辑
bin/webstorm.sh，在#!/bin/sh后加两行：export LANG=zh_CN.UTF-8和export LC_ALL=zh_CN.UTF-8 - 所有平台：编辑
webstorm64.vmoptions（Windows/macOS）或webstorm.vmoptions（Linux），追加一行：-Dfile.encoding=UTF-8 - Run Configuration → Environment Variables 里也得加：
file.encoding=UTF-8（IDEA 系列常漏这一层）
右下角状态栏显示 GBK 或 ISO-8859-1 怎么办
打开一个乱码文件，右下角显示的编码是 WebStorm 当前「猜测」的结果，并非真实编码。点击它后：
- 选带 ⚠️ 的编码（如
GBK）→ 弹窗问 Reload or Convert -
Reload：仅重新解析，不改磁盘，适合安全预览是否能正确显示 -
Convert：真写回磁盘，**必须确认原始内容确实是该编码**，否则中文变问号 - 一旦执行过
Convert，WebStorm 就会把这个文件和该编码绑定，下次打开不再瞎猜
最容易被跳过的其实是 Convert Files to UTF-8 操作中「指定源编码」这一步，以及 Terminal 的 chcp 65001 和 VM 参数 —— 编辑器里看着正常，终端一输出就崩，问题八成出在这儿。
