必须先禁用内置vintage,否则vintageous无法稳定工作;需在用户设置中将"ignored_packages"设为["vintage"]并彻底重启,再安装vintageous,否则按键冲突、esc失灵、:q报错等问题频发。

安装Vintageous前必须禁用内置Vintage
不先禁用Sublime自带的Vintage插件,Vintageous根本无法稳定工作——按键会随机失效、Esc有时退出插入模式有时关自动补全、:w能用但:q报错,全是共存导致的冲突。
打开 Preferences → Settings – User,确认 "ignored_packages" 列表里包含 "Vintage",例如:"ignored_packages": ["Vintage"] 或 "ignored_packages": ["Vintage", "SomeOtherPlugin"]。如果不是,手动加上;如果是空数组 [],也得改成带 "Vintage" 的版本。改完保存,**必须彻底退出 Sublime Text(关闭所有窗口 + 任务管理器杀进程)再重开**,热重载不触发插件卸载。
安装Vintageous后Esc没反应?先查输入法和上下文
Esc失灵最常见原因不是插件装错了,而是被系统或编辑器自身劫持:
- Windows 中文输入法(微软拼音、搜狗)在中文状态下直接吞掉
Esc,切到英文键盘布局再试 - 远程桌面(RDP)也会拦截
Esc,此时唯一可靠替代是Ctrl+[,它和Esc在 Vintageous 中功能完全等价 - 函数参数提示、代码补全弹窗正开着时,
Esc优先关弹窗而非退出插入模式——在 Vintageous 用户设置中加"pressing_esc_disables_auto_complete_window": true可修复
验证是否生效:打开任意文件,按 Esc,再输入 :,底部出现命令行提示符即为成功。
让yy/dd真正同步系统剪贴板
默认情况下,Vintageous 的 y、d 操作只写入内部寄存器,复制的内容粘贴不到终端、浏览器或其他应用里——这不是 bug,是默认行为。
打开 Preferences → Package Settings → Vintageous → Settings – User,加入这一行:
{"vintageous_use_sys_clipboard": true}
macOS 用户额外注意:需前往「系统设置 → 隐私与安全性 → 辅助功能」,勾选 Sublime Text,否则该配置静默失败,无任何提示。
jj映射和默认进入命令模式要手动配
Vintageous 默认不启用 jj 退出插入模式,也不默认以命令模式打开文件——这两个都是高频打断点,必须手动补上。
在 Preferences → Key Bindings – User 中添加:
[
{
"keys": ["j", "j"],
"command": "exit_insert_mode",
"context": [{"key": "setting.command_mode", "operand": false}]
}
]
同时,在 Vintageous 用户设置中加:
{"vintage_start_in_command_mode": true}
这两项不配,你会反复经历“写完一行想删,按 Esc 没反应,只能鼠标点一下再按 dd”这种破坏编辑流的操作。
真正麻烦的不是装不上,而是装完发现 ci" 有效但 g~iw 报错,或者 Ctrl+v 列块选择和 Sublime 原生多光标打架——这些都得靠 context 规则和命令重绑定来调,不是开箱即用的事。











