neovintageous 无法正常使用是因配置错误:需清除 ignored_packages 中的 "vintage"、重启 sublime、启用 vintage_start_in_command_mode 和 vintageous_enable_ex_command_mode 等关键设置。

NeoVintageous 装完不能当 Vim 用,不是插件不行,是默认配置让它半身不遂——Esc 没反应、hjkl 不动、:set 报错、新文件一开就卡在插入模式,全是因为关键配置没开、Vintage 没禁、重启没做。
为什么 Esc 按了没反应,状态栏也不显示 COMMAND MODE
根本不是插件没装上,而是 Sublime 自带的 Vintage 插件和 NeoVintageous 同时加载,互相劫持输入事件。哪怕只装了 NeoVintageous,只要用户设置里还留着 "ignored_packages": ["Vintage"],Vintage 就会偷偷运行,把 Esc 和 hjkl 全部截走。
- 打开
Preferences → Settings,检查右侧「User Settings」中"ignored_packages"数组,确保"Vintage"完全不在里面(比如改成"ignored_packages": []或删掉这一项) - 保存后必须完全退出 Sublime Text 进程(Windows/macOS/Linux 都要 Quit,不是关窗口),再重开
- 启动后按一次
Esc,看右下角状态栏是否出现COMMAND MODE;没出现?说明 NeoVintageous 根本没接管成功,回上一步复查
新文件一打开就进 Insert Mode,怎么改默认为 Normal Mode
NeoVintageous 默认启用“兼容模式”:新文件、新建标签页、从侧边栏双击打开,全部直入插入模式。这不是 bug,是设计选择,但对 Vim 用户等于每天重复三次 Esc 才能开始编辑。
- 打开
Preferences → Package Settings → NeoVintageous → Settings – User - 添加这两项(缺一不可):
"vintage_start_in_command_mode": true和"pressing_esc_disables_auto_complete_window": true - 前者让新文件直接进命令模式;后者防止 Sublime 的补全弹窗吃掉你的第一次
Esc—— 否则你会按三次Esc:第一次关补全框,第二次退出插入模式,第三次才真正进命令模式
:s/old/new/g 报 Unknown command,:set nu 也失败
NeoVintageous 默认只支持基础 Ex 命令(如 :w、:q!),:s、:set、:g、:registers 等需要显式开启命令行解析器,否则一律静默失败或报错。
- 在
NeoVintageous → Settings – User中添加:"vintageous_enable_ex_command_mode": true - 注意不是
"ex_mode": true(那是旧版 Vintageous 的写法,NeoVintageous 已弃用) - 开启后
:q会退出当前文件而非整个编辑器;如需退出全部标签页,用:qa! - 部分原生命令(如
:set clipboard=unnamed)会被覆盖,应改用 NeoVintageous 提供的等效配置项,例如"vintageous_use_sys_clipboard": true
所有配置修改后必须重启,且配置文件语法错误会导致整套 Vim 模式失效
NeoVintageous 的初始化逻辑非常脆弱:一个逗号少写、引号没闭合、键名拼错(比如写成 vintageous_enable_ex_command_mode 漏了末尾的 s),都会导致它在加载第一行时就静默退出——此时你按 Esc 还是没反应,hjkl 还是不动,但控制台不会报错,你也找不到线索。
- 每次改完
Settings – User或全局Preferences.sublime-settings,都必须完整退出并重启 - 重启后第一时间看状态栏是否显示
COMMAND MODE,这是唯一可靠的生效信号 - 如果出问题,先把配置文件还原成空对象
{},确认能否恢复基本功能,再逐行加回配置项排查











