Ctrl+Q是Sublime宏唯一可靠入口，按一次开始录制、再按停止；菜单项Tools→Record Macro大多无效；状态栏仅闪现“Recording macro”，易被忽略；录制需聚焦编辑区、执行有效键盘操作，禁用鼠标及UI面板交互。
Ctrl+Q 按下就录，再按就停——这才是 Sublime 宏真正生效的唯一入口，菜单里的 Tools → Record Macro 大概率不干活。
为什么按了 Ctrl+Q 没反应？
不是没录上，是它根本没提示你“正在录”，只在状态栏右下角闪一下 Recording macro，一眨眼就没了。常见误判点：
- 光标没在编辑区：侧边栏、命令面板、设置页里按
Ctrl+Q无效 - 录制期间没做任何可记录操作：只移动光标不算（
right_arrow算，left_arrow也算），但纯悬停不按键，宏内容为空 - macOS 用户踩坑：
Cmd+Q默认是退出应用，得先关掉系统级快捷键，或直接用Ctrl+Q
录制中哪些操作会静默失败？
Sublime 宏只认键盘流，所有“非键盘触发”的行为都会导致中断或漏录：
- 鼠标拖选、点击、
Ctrl+Click多光标 —— 完全不记录，且后续光标位置错乱 - 弹出
Ctrl+F查找框、Ctrl+Shift+P命令面板、保存对话框 —— 录制立刻静默终止，后面按键全丢 - 切换标签页、点侧边栏、右键菜单 —— 不记录，还可能让光标跳到不可预期位置
- 依赖插件的功能（如 Emmet 的
Tab补全）—— 只录下Tab键，回放时若文件类型不对或插件禁用，就卡住
run_macro_file 快捷键总不触发？检查这三处
90% 的“快捷键失效”问题都卡在这三个硬性条件上，Sublime 不报错，只沉默：
-
"command"必须小写且拼写精准："run_macro_file"，写成"RunMacroFile"、"run-macro-file"都无效 -
"file"值必须是完整包路径："Packages/User/add_semicolon.sublime-macro"，不能省略Packages/User/，不能用./或绝对路径 - 快捷键组合避开单独
Shift：["shift+;"]不生效，改用["ctrl+alt+;"]或["ctrl+alt+m"]
保存后务必打开 Preferences → Browse Packages…，进 User/ 文件夹确认文件真实存在，名字大小写也得一致。
手动编辑 .sublime-macro 文件比重录更高效
所有宏文件本质就是 JSON 数组，打开就能改。比如你录了 End → ; → ↓，但发现偶尔光标不在行尾，可以加一步前置定位：
[{"command": "move_to", "args": {"to": "eol"}}, {"command": "insert", "args": {"characters": ";"}}]
常见可安全编辑的命令有 move_to、insert、select_line、move；别往里塞插件命令（如 emmet_expand_abbreviation），Sublime 不认。
最易被忽略的是上下文一致性：宏不管你是 Python 还是 HTML，也不管有没有选中文本——它只照着你录时的光标位置和按键顺序硬执行。每次回放前，手动把光标放到预期起始点，比指望宏自动判断靠谱得多。
