必须安装 vim-mode-plus 而非已弃用的 vim-mode，因 atom 1.60+ 废弃旧 api 导致 vim-mode 无法加载、按键失灵甚至卡死；装后须重启 atom，否则 j/k 在 normal 模式下不响应。
必须装 vim-mode-plus，不能装已弃用的 vim-mode；装完不重启 Atom，j/k 会失灵，这是最常踩的坑。
为什么不能装 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等命令
切换模式的核心快捷键不是“高级技巧”，而是基础生存线
别依赖鼠标点状态栏切模式，效率断崖下跌。记住这五组不可替代的组合：
-
i：Normal → Insert（光标前）｜a：Normal → Insert（光标后） -
Esc或Ctrl+[：任意模式 → Normal（后者更防误触） -
v：Normal → Visual Character（字符级选择）｜V：Normal → Visual Line（整行） -
Ctrl+v（Win/Linux）或Cmd+Shift+v（Mac）：Normal → Visual Block（列选择） -
Ctrl+Shift+P：呼出命令面板，搜vim-mode-plus:toggle可临时禁用/启用 Vim 模式（调试冲突时极有用）
块模式下多行插入后必须按 Esc 才生效，按 Enter 会换行而非退出，这是新手最易卡住的环节。
