macroregisters 与 vim 原生寄存器共用命名空间导致 @a 失效；宏录制需注意模式上下文（如 operator-pending）、寄存器大小写区分（大写专用于宏）；自定义键绑定必须添加 vi_mode context；异步命令需用 run_command + async 避免卡死。
MacroRegisters 与寄存器命名冲突会导致 @a 失效
Vintageous 的宏录制依赖 MacroRegisters 类管理，但它的寄存器名和 Vim 原生寄存器（如 "a、"0）共用同一命名空间。如果你在普通模式下执行了 "ayy（把当前行复制进寄存器 a），再用 qa 录制宏，@a 就会执行寄存器 a 的内容（即粘贴那行），而不是你录的宏——因为 @a 默认查的是寄存器，不是宏注册表。
避免方式：
- 录制宏时统一用小写字母
a–z，但确保此前没用"a等写入过内容 - 更稳妥的做法是用大写字母录制：
qA→ 操作 →q，再用@A执行；大写寄存器在 Vintageous 中专用于宏，不与 yank/paste 寄存器混用 - 检查寄存器状态：命令模式下输入
:reg，看输出里a是text还是macro类型
多模式下宏无法跨模式回放？关键在 operator-pending 模式陷阱
你在可视模式（v）下录了一个 ciw 替换词的宏，回放时却只移动光标不触发替换——这通常是因为宏被记录在了错误的模式上下文中。Vintageous 的 MacroRegisters 按模式分桶存储，ciw 实际由三步组成：c（进入 operator-pending）、iw（文本对象），而 c 本身会切换到 operator-pending 模式，后续按键若没被该模式捕获，就丢弃了。
实操要点：
- 录制前先确认当前模式：
Ctrl+Shift+P输入Vintageous: Show Mode，确保起始是normal或visual，别从insert开始按q - 对含操作符的命令（
ciw、d$、yip），必须在normal模式下启动录制：q{reg}，然后立刻输入完整序列，不要中途切模式 - 如果已录错，删掉
Packages/User/Vintageous/macro.py（或重命名备份），重启 Sublime —— 宏数据存在内存+缓存中，不重启不会清空
自定义键绑定触发宏时，context 必须显式声明 vi_mode
想用 Ctrl+e 直接执行 @a 宏，但在用户按键文件里写：
[
{
"keys": ["ctrl+e"],
"command": "vi_repeat_macro",
"args": {"repeat_count": 1, "register": "a"}
}
]
结果没反应。问题出在 vi_repeat_macro 命令只在 Vintageous 的命令模式（normal）下注册，而 Sublime 默认按键绑定全局生效，没有上下文过滤，所以它根本收不到触发。
正确写法必须加 context：
- 在
Preferences → Package Settings → Vintageous → Key Bindings – User中添加 -
context里要明确匹配vi_mode状态，例如：{"key": "vi_mode", "operator": "==", "operand": "normal"} - 完整示例：
[
{
"keys": ["ctrl+e"],
"command": "vi_repeat_macro",
"args": {"repeat_count": 1, "register": "a"},
"context": [
{"key": "vi_mode", "operator": "==", "operand": "normal"}
]
}
]
宏里调用外部命令（如 shell_exec）会卡死，改用 run_command + async
有人尝试在宏里录下 :terminal 或 :shell_exec，回放时界面冻结。这是因为 Vintageous 的宏系统是同步执行的，而 :terminal 启动子进程需异步等待，宏引擎直接卡在 I/O 阻塞点。
绕过方案：
- 不用宏录命令行操作，改用
run_command绑定：在 Vintageous 用户设置中加 -
"vintageous_ex_mode_commands": {"mybuild": "build"}，然后绑定Ctrl+b到vi_ex_command并传mybuild - 或者写 Python 插件，在
Packages/User/下建my_macro_runner.py，用sublime.set_timeout_async调用view.window().run_command("build")，再绑定按键触发该插件
真正难搞的不是怎么录，而是宏一旦涉及跨模式、跨寄存器、跨进程，Vintageous 的底层事件分发链就很容易断在某个隐式状态切换上——比如 operator-pending 模式残留、寄存器类型混淆、或 context 匹配失败，这些都不会报错，只会静默失效。
