Ctrl+Q（Win/Linux）或Cmd+Q（macOS）是唯一可靠录制入口，因Sublime宏依赖隐式快捷键触发，按下即进入录制状态并显示“Recording macro”，菜单项Tools→Record Macro在多数版本中响应不稳定或无效。
Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS）是唯一可靠入口，菜单里的 Tools → Record Macro 基本不生效。
为什么按 Ctrl+Q 才算真正开始录制
Sublime 的宏录制是隐式触发的：按下 Ctrl+Q 瞬间即进入录制状态，状态栏右下角会闪现 “Recording macro”——不显眼但真实存在。再按一次 Ctrl+Q 就停止并自动回放。菜单项 Tools → Record Macro 在多数版本中响应迟钝、易误点成子菜单，且不保证触发完整录制流程，属于“看起来能用，实际靠不住”的设计。
常见误判是：按了 Ctrl+Q 没看到明显提示，就以为失败，转而去点菜单；结果真正想录的操作全漏掉了。
录制前必须做的三件事
宏只机械复现按键流，没预演、不纠错、不理解语义。以下操作不做，十有八九回放失败：
- 清空当前文件或新开空白标签页，用键盘走一遍目标流程（比如
End→;→↓），确认节奏干净、无多余光标跳动 - 禁用鼠标：拖选、点击、
Ctrl+Click多光标全不记录，还会导致后续步骤错位 - 关闭所有干扰弹窗：
Ctrl+F查找框、Ctrl+Shift+P命令面板、保存对话框一旦出现，录制静默中断，后面所有操作都不存
回放时没反应？先查这三点
点了 Tools → Playback Macro 却光标一跳就停，不是宏坏了，而是环境不匹配：
- 光标不在预期位置：
delete_line是删“当前行”，你得手动把光标移到目标行首，宏不会自动扫描全文 - 上下文丢失：比如录制时按
Tab触发 Emmet 补全，但回放时文件后缀不是.html，或 Emmet 插件被禁用，动作直接卡住 - 宏还在内存里没保存：刚录完没执行
Tools → Save Macro就关 Sublime，宏彻底消失——它不像 VSCode 那样自动持久化
保存宏文件最容易踩的坑
保存不是点“确定”就完事，路径和命名错一个，快捷键永远调不出来：
-
file值必须是完整包路径，例如"Packages/User/add_semicolon.sublime-macro"；不能省略Packages/User/，不能用./或绝对路径 -
command必须小写拼成run_macro_file，写成RunMacroFile或run-macro-file都无效 - 快捷键组合避免单独用
Shift，比如["shift+;"]不生效；推荐["ctrl+alt+;"]或["ctrl+alt+m"] - 保存后务必打开
Preferences → Browse Packages…，进User/文件夹确认文件真实存在，且内容是合法 JSON 数组
宏文件本质是纯 JSON，结构扁平、命令明确，手动编辑比重录更高效。但别指望它处理剪贴板、跨行正则或条件判断——它就是一段按键录像，越简单、越可控，越不容易在下次回放时突然失效。
