首次启动webstorm必须完成三步：选对keymap（如vs code用户选对应方案）、激活非商业许可证、安装插件后重启ide，否则将导致快捷键失效、补全弱化、markdown/eslint不生效。
WebStorm 不需要“从零手动配齐”，但必须避开几个默认陷阱，否则编辑器会卡顿、插件不生效、快捷键失灵——关键在首次启动时的三步选择。
首次启动时选错 Keymap 就等于废掉一半效率
WebStorm 启动后第一屏就问你用什么 Keymap，默认是 IntelliJ IDEA，但如果你习惯 VS Code 或 Sublime，直接选错会导致后续所有快捷键（比如 Ctrl+P 查文件、Ctrl+Shift+A 搜操作）全部失效，且后期切换会丢失自定义绑定。
- 确认自己常用编辑器：VS Code 用户选
Visual Studio Code；Sublime 用户选Sublime Text；Vim 用户必须装IdeaVim插件后再设为Vim - 别点“Skip”跳过这步——跳过等于锁定默认
IntelliJ IDEA映射，之后改需重置全部快捷键 - 改完 Keymap 后，立刻试按
Shift+Shift（随处搜索），能弹出搜索框才算生效
非商业许可证没激活 = 代码补全变弱 + 调试器禁用
2024.2.4 版起，个人免费版需显式激活 Free Non-Commercial License，否则 WebStorm 会降级为“试用模式”，表现为：Ctrl+Space 补全只给基础语法、断点打不上、Run 按钮灰掉。
- 启动后弹出登录页，**不要直接填邮箱点登录**——先点页面右下角
Configure→Manage License→ 选Free Non-Commercial - 如果已误入登录流程，关掉窗口，进
Help→Register→ 切换 License 类型 - 激活成功后，状态栏右下角会显示
Non-commercial license，不是Evaluation
插件装了不重启 = Markdown 高亮/ESLint 无效
WebStorm 原生不支持 Markdown 语法高亮和实时预览，ESLint 也不内置。装完插件必须重启，否则配置项不加载、设置面板里找不到对应入口。
- 装
Markdown Navigator（推荐）或Markdown（JetBrains 官方轻量版）→ 安装后点Restart IDE按钮，别点右上角叉关闭 - 装
ESLint插件后，还需在Settings→Languages & Frameworks→JavaScript→Code Quality Tools→ESLint里勾选Automatic configuration - 插件列表里看到灰色“Enable”按钮，说明没重启——重启后变蓝，才真正启用
项目级配置覆盖全局设置，但 .idea 文件不能删
很多人删掉项目根目录的 .idea 文件夹想“重置配置”，结果导致代码格式化规则丢失、运行配置消失、甚至无法识别 node_modules ——这个文件夹是项目专属配置的唯一载体。
-
.idea里的editorconfig.xml控制缩进、换行符；workspace.xml记录断点、打开的标签页；删了就得重新配 - 想统一团队风格？把
.idea/codeStyles/Project.xml提交到 Git，其他人检出后自动生效 - 真要清理，只删
.idea/workspace.xml（不影响代码行为），保留其他文件
最常被忽略的其实是字体渲染——Mac 上默认启用抗锯齿会让中文发虚，Windows 上默认禁用又显得太硬。进 Settings → Editor → Font 里勾选 Use fractional metrics（Mac）或 Disable font smoothing（Windows）才是真实可用的清晰度。
