必须首次启动时拒绝导入旧配置，手动设置字体为fira code或jetbrains mono、字号14并启用连字，编码统一设为utf-8且勾选透明转换，禁用database tools等非必要插件，仅安装rainbow brackets等刚需插件，最后重启生效。
新装 WebStorm 后直接套用旧配置，大概率会遇到 ESLint 不生效、.properties 文件中文乱码、括号配对失效、启动变慢等问题——这不是你操作错了，而是默认行为和旧配置冲突导致的。必须从零开始手动设几处关键项，其他才能稳住。
首次启动时拒绝导入旧设置
弹窗出现“Import settings from previous version”时，立刻点 Don’t import settings。旧版残留的 .idea 配置、损坏的插件缓存、过期的 node_modules 路径映射，都会让新版本语法校验失灵或跳转失败。哪怕你只换了个大版本（比如 2024.3 → 2025.1），也不建议复用。
字体、编码、连字三处必须改
Windows 上默认 Consolas 渲染中文注释是方块；macOS/Linux 默认 UTF-8，但老项目常是 GBK；而 .properties 文件不启用透明转换，键值对里的中文永远显示为 \u4f60\u597d。
-
Settings → Editor → Font：选Fira Code或JetBrains Mono，字号调至14，勾选Enable font ligatures -
Settings → Editor → File Encodings：Project encoding 和 Default encoding for properties files 都设为UTF-8，底部Transparent native-to-ascii conversion必须打钩
插件只留刚需，禁用所有“看着有用”的默认项
开箱即用的插件列表里混着几个拖慢启动、又和前端开发无关的模块，比如 Database Tools and SQL、MyBatis、Python。它们不报错，但会让 IDE 打开变慢、索引卡顿、甚至干扰 package.json 解析。
- 先全禁用，再按需启用：
Rainbow Brackets（括号配对）、Markdown Navigator（原生 Markdown 渲染） -
GitToolBox慎装——它依赖系统git命令，若PATH没配好，会持续弹出git not found提示 - 语言相关插件（如
Svelte）要单独装：进Settings → Plugins，Marketplace 搜索并启用，不是“开箱就有”
关掉自动更新和遥测，尤其在内网或离线环境
WebStorm 2025.1+ 默认开启后台检查更新和 Send usage statistics，在无外网权限的机器上会导致启动卡顿、证书校验失败、甚至阻塞项目加载。
-
Settings → Appearance & Behavior → System Settings → Updates：取消勾选Check for updates automatically -
Settings → Appearance & Behavior → System Settings → Privacy：关掉Send usage statistics和Enable JetBrains AI Assistant - 改完必须重启一次——很多设置（尤其是编码和插件）不重启不生效
最容易漏的是 File Encodings 页底部那个 Transparent native-to-ascii conversion 开关，它不显眼，但一漏，所有 .properties 文件里的中文就彻底救不回来。
