ctrl+q 是 sublime 宏录制/播放的唯一可靠入口，仅记录键盘操作且无上下文理解；宏失效主因是回放时位置偏移、文件类型或插件状态变化；保存宏需严格遵循 command 小写、file 为完整包路径、文件名全小写加 .sublime-macro 后缀。
Ctrl+Q 是唯一可靠的录制/播放入口，其他方式基本不可靠。 它不是“可选快捷键”，而是 Sublime 宏功能的硬性开关——按一次开始，再按一次停止，中间所有键盘操作（仅键盘）都会被记录。菜单项 Tools → Record Macro 在多数版本中不生效，状态栏右下角闪一下 Recording macro 就是唯一提示，不显眼但真实存在。
为什么 Ctrl+Q 录制后回放总卡住
宏只复现按键流，不理解上下文。它不管当前文件类型、光标是否在单词里、有没有重复词，只认“你录的时候在哪、按了什么、顺序怎样”。常见失效场景：
-
Ctrl+D回放失败 → 录制时那行有重复词，回放时没了，选区扩展中断，后续全偏移 - Tab 补全卡住 → 回放文件类型不是
.html或 Emmet 插件未启用 - 光标停在行中却只删了后半截 → 录制前没按
Home或Ctrl+Home保证从行首开始
解决思路：少依赖文本内容匹配（比如“选中单词”），多用确定性位置操作（比如 move_to 到行尾、insert 分号、move 下行）。
保存后快捷键不生效？90% 是路径或命名写错
Sublime 不报错，只沉默失效。关键三处必须严丝合缝：
-
"command"必须小写且拼写精准：run_macro_file，写成RunMacroFile或run-macro-file全无效 -
"file"值必须是完整包路径：Packages/User/add_semicolon.sublime-macro，不能省略Packages/User/，不能用./或绝对路径 - 文件名只能含小写字母、数字、下划线，必须以
.sublime-macro结尾；AddSemicolon.sublime-macro或中文名会加载失败
保存后务必打开 Preferences → Browse Packages…，进 User/ 文件夹确认文件真实存在、名字全小写、无空格、内容为合法 JSON 数组。
手动编辑 .sublime-macro 文件比重录更高效
所有宏文件本质就是扁平 JSON 数组，结构清晰，比如：
[{"command": "move_to", "args": {"to": "eol"}}, {"command": "insert", "args": {"characters": ";"}}]
你可以直接删掉冗余命令（比如误录的 select_line），加 {"command": "select_line"} 强制对齐上下文，或插入 move 命令归位。但注意：它无法处理条件逻辑、动态内容或鼠标交互——能靠键盘走通的流程才适合做宏。
最常被忽略的点是：宏不保存上下文，只保存按键顺序和位置移动。哪怕你录得再准，只要回放时光标不在录制时的相对位置，或者文件类型/插件状态变了，它就大概率卡在第 3 步不动。调试最快的方式，就是打开那个 .sublime-macro 文件，看 JSON 里是不是真有你要的命令序列。
