Sublime宏回放失败主因是光标位置偏移或上下文不匹配；必须存为Packages/User/xxx.sublime-macro，绑定快捷键须用run_macro_file命令并严格遵循JSON格式。
Ctrl+Q 录制但回放失败？先确认光标和上下文
Sublime 的宏不是智能脚本，它只机械重放你按下的每一个键。回放时没反应，90% 是因为光标不在录制时的起始位置，或当前文件类型/插件状态不匹配。比如你录了 Tab 补全 Emmet，回放时文件后缀不是 .html，或者 emmet 插件被禁用，动作就卡在 Tab 上不动。
常见错误现象：
- 光标停在行中某词里，却期望宏“删整行”——实际只删光标后内容
- 录制时在 Python 文件里用了
ctrl+shift+p调命令面板，回放时弹出面板但无后续操作（面板打开即中断录制） - 用鼠标拖选文字后按
ctrl+x，宏里根本没记录选区动作，回放只执行剪切空内容
实操建议：
- 每次录制前，把光标移到行首或统一锚点（如用
ctrl+home定位） - 避免任何非键盘行为：不切标签页、不点侧边栏、不右键、不调设置窗口
- 验证是否录对：停止录制后立刻按
ctrl+shift+p搜Playback Macro回放一次，看是否复现
保存路径写错，宏就永远加载不出来
Sublime 只认一种有效路径：Packages/User/add_semicolon.sublime-macro。写成 ./add_semicolon.sublime-macro、user/add_semicolon.sublime-macro 或本地绝对路径（如 C:\...），都不会报错，但快捷键按了也没反应。
必须满足三个硬性条件：
- 文件名以
.sublime-macro结尾，不能漏扩展名 - 必须存到
Packages/User/目录下——通过Preferences → Browse Packages…打开该目录，直接看到文件才算落地 - 文件名禁用中文、空格、特殊符号；
AddSemicolon.sublime-macro和add_semicolon.sublime-macro是两个不同文件，大小写敏感
验证是否加载成功：按 ctrl+shift+p 输入 Run Macro，如果列表里没出现你的文件名，就是路径或命名错了。
绑定快捷键必须用 run_macro_file 命令
别用 playback_macro 绑定快捷键——它只能播内存里最后一次录制的临时宏，关掉 Sublime 就丢。要复用已保存的宏，唯一可靠方式是 run_macro_file。
用户键位配置（Preferences → Key Bindings 右侧面板）必须严格写成：
[{"keys": ["ctrl+alt+;"], "command": "run_macro_file", "args": {"file": "Packages/User/add_semicolon.sublime-macro"}}]
容易踩的坑：
-
"command"必须小写拼成run_macro_file，写成Run_Macro_File或run-macro-file都无效 -
"file"值是字符串，斜杠方向统一用正斜杠/（Windows 也一样） - 快捷键组合里不要单独用
shift，["shift+;"]是无效的；推荐["ctrl+alt+;"]这类稳定组合
手动编辑 .sublime-macro 文件比重录更高效
保存后的宏本质是 JSON 数组，每项是一个 {"command": "...", "args": {...}} 对象。你可以用 Sublime 直接打开它删冗余步骤、调顺序，甚至复制粘贴同一段命令实现“执行三遍”效果。
例如这个宏本意是“跳到行尾 + 插入分号”，但录多了 right 移动：
[{"command":"move_to","args":{"to":"eol"}}, {"command":"move","args":{"by":"characters","forward":true}}, {"command":"insert","args":{"characters":";"}}]
可以删掉第二行，让它更鲁棒。也可以插入 {"command":"select_line"} 强制基于整行操作，避免因光标位置偏差导致错行。
注意：所有 command 名必须是 Sublime 原生支持的 text_command，插件命令（如 side_bar_files）不能用；一旦含逻辑判断（如“如果含数字就加引号”），宏就该停手，换正则替换或插件。
