必须重启 webstorm 才能真正启用 ideavim，否则光标不块状、esc 无反应、i 无法进入插入模式；安装后需点击弹窗“restart ide”，并正确配置 keymap、快捷键映射及 .ideavimrc 路径。
必须重启 WebStorm 才能真正启用 IdeaVim，不重启等于没装。 光标不会变块状、Esc 按了没反应、i 进不了插入模式——这些全是没重启的典型表现。
安装 IdeaVim 插件后必须重启 IDE
在 WebStorm 中装完插件只是下载完成，IdeaVim 的 Vim 引擎需要完整加载 IDE 启动流程才能挂载。只点「Close」设置窗口或「OK」都不行。
- 安装路径：
Ctrl+Alt+S→Plugins→ 搜索IdeaVim→ 点Install - 安装完成后，右下角会弹出「Download complete」提示，**此时务必点击弹窗里的
Restart IDE** - 重启后，光标默认是块状（Normal 模式），按
i才能输入文字；状态栏左下角也会显示-- NORMAL -- - 如果仍无反应，检查是否误点了「Disable」或
Tools | Vim被手动关掉了
Keymap 冲突时不能直接改 Default
WebStorm 禁止编辑内置的 Default 键位图，所有修改都会被丢弃或回退。想让 Ctrl+C 在 Vim 模式下仍执行复制（而不是触发 Vim 的 y），必须走「复制 + 重绑定」流程。
- 进
Settings→Keymap→ 右键Default→Copy...，起名如MyVimKeymap - 确保新名字被高亮选中（右侧显示
Active keymap: MyVimKeymap） - 搜索
Copy动作 → 右键 →Add Keyboard Shortcut→ 按Ctrl+C - 若提示冲突（比如已被
Editor Actions → Copy占用），选Leave，不是Remove
Ctrl+[ 不生效？因为被 IDE 占用了
标准 Vim 里 Ctrl+[ 等价于 Esc，但在 WebStorm 的 Default 键位图中，它默认绑定到 Jump to Source。即使你复制了 Keymap，这个快捷键也不会自动继承为 Vim 行为。
- 进
Settings→Keymap→ 切换到你的MyVimKeymap - 搜索
Escape或Cancel，找到对应动作（通常是Editor Actions → Escape） - 右键 →
Add Keyboard Shortcut→ 按Ctrl+[，确认添加 - 再搜
Jump to Source，把它原来的Ctrl+[快捷键删掉（右键 →Remove）
Vim 模式和 IDE 快捷键共存要手动设处理策略
像 Ctrl+Alt+T（包裹代码）、Ctrl+B（跳转定义）这类高频操作，默认会被 IdeaVim 拦截，变成普通按键输入，IDE 功能就失效了。
- 进
Settings→Editor | Vim - 找到你要保留的快捷键（如
Ctrl+Alt+T），点击右侧下拉菜单 - 设为
IDE：WebStorm 处理（推荐对重构、导航类操作这么做） - 设为
Vim：IdeaVim 处理（例如把Ctrl+]设为跳转，替代Ctrl+B） - 设为
Undefined：每次按都弹通知，适合调试阶段排查冲突
最容易被忽略的是：IdeaVim 的配置文件 .ideavimrc 默认不生效，除非你把它放在正确路径（Windows 是 %HOMEPATH%\_ideavimrc，macOS/Linux 是 ~/.ideavimrc），而且 WebStorm 启动时读取的是 JVM 的 user.home 值——如果你改过这个参数，.ideavimrc 就可能根本没被加载。
