必须安装 vim-mode-plus 而非已弃用的 vim-mode，装完需重启 Atom，否则 j/k 在 Normal 模式失灵；vim-mode 因 Atom 1.60+ 废弃旧 API 已停更，所有新功能仅在 vim-mode-plus 维护。
必须装 vim-mode-plus，不能装已弃用的 vim-mode；装完不重启 Atom，j/k 在 Normal 模式下直接失灵——这是最常踩的坑。
为什么不能装 vim-mode
Atom 1.60+ 已废弃旧版服务 API，vim-mode 无法加载，轻则按键无响应，重则整个编辑器卡死。官方早已标记为 deprecated，GitHub 仓库也停止维护。所有新功能、修复、兼容性适配（包括 macOS Sequoia、Windows 11 文件系统路径处理）都只在 vim-mode-plus 中更新。
- 命令行安装最可靠：
apm install vim-mode-plus（别加--dev） - 国内用户若报错
ENOTFOUND或超时，大概率是 APM 源被墙，需配代理：proxychains4 apm install vim-mode-plus - 装完立刻重启 Atom——这是硬性要求，不是建议
Normal 模式进不去？先查这三件事
按了 Esc 没反应、j/k 不动、光标乱跳，90% 是配置没对齐或冲突未清。
- 确认
vim-mode插件已被禁用：Settings → Packages → 搜索vim-mode→ 点击Disable - 检查是否开了 Soft Wrap：Settings → Editor → Soft Wrap → 关掉它；否则
V行模式会按软换行选，不是物理行 - macOS 用户注意：
Cmd+v默认是粘贴，不会触发块模式；块模式必须用Ctrl+v（Win/Linux）或Cmd+Shift+v（Mac）
一启动就进 Normal 模式？改默认模式
Atom 默认打开文件后处于 Insert 模式，这不是 bug，是设计。想让新标签页一打开就在 Normal 模式，得手动改 Keymap。
- 打开 Keymap 文件：Atom → Keymap…（macOS）或 File → Keymap…（Win/Linux）
- 加这一行：
'atom-text-editor:not(.mini)': 'enter': 'vim-mode-plus:activate-normal-mode' - 保存后，新打开的文件（非已有编辑中的）将直接进入 Normal 模式，光标静止可立即执行
w、f等命令
块模式下多行插入后必须按 Esc 才生效
按 Enter 会换行而非退出，这是新手最易卡住的环节。块模式（Ctrl+v / Cmd+Shift+v）选中多列后，按 I 进入插入模式，输入内容，**必须按 Esc 才能将相同文本批量写入所有光标位置**；如果误按 Enter，只会新增一行，其余光标位置什么也不会发生。
折叠、搜索、多光标这些高级能力都依赖 Normal 模式稳定激活——只要 j/k 能动，其他功能才真正可用。
