必须重启IDE才生效，安装IdeaVim后需点击右下角“Restart IDE”而非仅关闭设置窗口，否则插件不加载、光标不变块状、仍为普通编辑模式。
安装 IdeaVim 插件必须重启才生效
不重启 WebStorm，IdeaVim 插件不会真正加载，光标也不会变成 Vim 风格的块状。安装后状态栏会提示「Download complete」，但此时仍处于普通编辑模式。
- 打开设置：按
Ctrl+Alt+S（Windows/Linux）或Cmd+,（macOS） - 进入
Plugins→ 搜索IdeaVim→ 点击Install - 安装完成后必须点击右下角弹出的
Restart IDE，不能只关掉设置窗口 - 重启后，光标默认进入 normal mode（块状），按
i才能输入文字
Keymap 冲突时必须复制 Default 再修改
WebStorm 禁止直接编辑 Default 键位图，所有修改都会被忽略或回退。想让 Ctrl+C 在 Vim 模式下仍执行复制，而不是触发 Vim 的 y（yank），就得走「复制 + 重绑定」流程。
- 进
Settings → Keymap，右键Default→Copy，起名如MyVimKeymap - 确保新名字被高亮选中（右侧显示
Active keymap: MyVimKeymap） - 搜索
Copy动作，在其上右键 →Add Keyboard Shortcut→ 按Ctrl+C - 若提示冲突（比如已被
Editor Actions → Copy占用），选Leave，不是Remove
Vim 模式与 IDE 快捷键共存需手动配置处理策略
默认情况下，Ctrl+Alt+T（包裹代码）这类组合键在 Vim 模式下会被 IdeaVim 当作普通按键吞掉，而不是触发 WebStorm 功能。得在 Vim 设置里明确告诉 IDE：哪些快捷键交给 IDE，哪些留给 Vim。
- 按
Ctrl+Alt+S→ 进入Editor → Vim - 找到你常用的快捷键（如
Ctrl+Alt+T），点击右侧下拉菜单 - 设为
IDE：让 WebStorm 处理该组合键（推荐对高频重构操作这么做） - 设为
Vim：保留为 Vim 命令（比如Ctrl+]可设为跳转定义，替代Ctrl+B） - 设为
Undefined：会弹通知提醒你冲突，适合调试阶段
系统级热键劫持是 Vim 快捷键失灵的最常见原因
很多用户以为 IdeaVim 没反应，其实是操作系统或第三方软件先截获了按键。比如 macOS 上 Cmd+Shift+P 默认调 Spotlight，Win10 上 Ctrl+Shift+Esc 弹任务管理器——WebStorm 根本收不到。
- macOS：进
System Preferences → Keyboard，勾选「将 F1、F2 等用作标准功能键」 - Windows：设置 → 蓝牙和其他设备 → 键盘 → 开启「使用 F1-F12 键作为标准功能键」
- 关闭可能劫持热键的软件：Alfred、Raycast、Logitech Options、Razer Synapse、微信截图工具
-
Fn键无法作为快捷键起始键——硬件层已拦截，WebStorm 识别不到
i 就按不出插入模式，Ctrl+C 就复制不了代码。 
