必须装 vim-mode-plus，禁用已弃用的 vim-mode；安装后重启 Atom，关闭 Soft Wrap，启用相对行号，确保文件类型识别正确，并注意 :substitute 默认仅作用于当前行。
必须装 vim-mode-plus，别碰已弃用的 vim-mode——后者在 Atom 1.60+ 上会卡死或让 j/k 完全失灵。
为什么装了 vim-mode 却不工作？
Atom 从 1.60 版起废弃旧版服务 API，vim-mode 无法加载核心逻辑。现象包括：Esc 没反应、j/k 不动、状态栏不显示 -- NORMAL --。这不是配置问题，是插件本身已被官方标记为 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模式下按键全部失效 - 安装后立刻进
Settings → Packages，搜vim-mode，把旧版vim-mode点Disable（两者共存会导致冲突）
vim-mode-plus 启用后光标乱跳、j/k 还是不动？
90% 是配置没对齐或 Atom 原生设置干扰。重点检查三项：
-
关掉 Soft Wrap：Settings → Editor → Soft Wrap → 关闭。开启后
V行模式会按软换行选，不是物理行，导致Vj选区错乱 -
启用相对行号：Settings → Packages →
vim-mode-plus→ Settings → 勾选Use Relative Line Numbers。否则5j这类移动无法直观定位 -
确认文件类型识别正确：右下角状态栏应显示
JavaScript、Python等，而非Plain Text。文本对象（如v i p选段落、v a {选大括号块）依赖语法解析，类型不对就失效
视觉模式（v/V/Ctrl+v）选不中内容？
不是插件坏了，是快捷键被截胡或行为理解偏差：
- macOS 上
Cmd+v是系统粘贴，块模式必须用Cmd+Shift+v；Windows/Linux 用Ctrl+v -
v按下后没反应？先确认没触发 Atom 原生快捷键（比如某些主题快捷键覆盖了v），可临时用Ctrl+Shift+P→ 输入vim-mode-plus:toggle关闭 Vim 模式测试是否冲突 -
Vj没选中整行？检查是否开了Soft Wrap（见上一条）；另外确保光标不在行首/行尾空白处，否则可能触发空行跳转 - 想快速选函数体？别手拖，用文本对象：
v a {（外层大括号）、v i {（内层）、v i p（当前段落）。前提是文件类型正确且代码有合法结构（如 JS 函数有{}）
:substitute 替换总只改一行？
:%s/foo/bar/g 在 vim-mode-plus 里默认只作用于当前行，不是整文件——这是新手最高频误解。
- 全文件替换用：
:substitute/foo/bar/g（注意开头冒号，不是:%s） - 更安全的做法：
ggVG全选 →:s/foo/bar/g，这样范围明确，不会漏行 - 正则需显式启用：
/\vfunction\s+\w+\(才匹配函数定义；/function\s+\w+\(会把括号当字面字符 - 批量加注释前缀？用块模式：
Ctrl+v→j多选几行 →I→ 输入//→Esc，所有行同步生效，比:s更直观、不易错行
复杂点在于：文本对象依赖语法高亮器，文件类型识别错误时 v i " 或 v a ( 就会失效；块模式下按 Esc 才真正应用插入，按 Enter 是换行——这个细节卡住很多人。
