Sublime Text宏录制必须用Ctrl+Q（Win/Linux）或Cmd+Q（macOS），保存路径须为Packages/User/xxx.sublime-macro，绑定快捷键时command为run_macro_file、file需全路径小写，回放失败主因是光标位置、文件类型或插件状态不一致。
Ctrl+Q 录制宏，别点菜单
Sublime Text 的宏录制只认 Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS），按一次开始，再按一次停止。状态栏右下角会闪一下 Recording macro——没看到也不代表失败，但点菜单里的 Tools → Record Macro 容易误触子项、响应延迟，且部分版本根本不触发真实录制。
常见错误现象：录完回放光标乱跳、只移动不输入、中途卡住。
- 录制时用了鼠标拖选或点击侧边栏 → 宏静默中断，后续步骤全丢
- 中途弹出
Ctrl+F查找框或Ctrl+Shift+P命令面板 → 录制终止，但无提示 - 按了
Esc或Ctrl+Z→ 这些都会被记入宏，回放时照样执行，可能 undo 掉刚输的内容
保存必须用 Packages/User/xxx.sublime-macro
刚录完的宏只存在内存里，关掉 Sublime 就彻底消失。必须走 Tools → Save Macro…，不能用普通“另存为”对话框；文件名必须以 .sublime-macro 结尾，路径必须是 Packages/User/ ——这个前缀不能省、不能替换成 ./ 或绝对路径，大小写也要一致（AddPrefix.sublime-macro 和 addprefix.sublime-macro 是两个文件）。
实操建议：
- 保存后立刻打开
Preferences → Browse Packages…，进User/文件夹确认文件真实存在 - 双击打开该文件，检查内容是否为合法 JSON 数组，例如：
[{"command":"move_to","args":{"to":"eol"}},{"command":"insert","args":{"characters":";"}}, {"command":"move","args":{"by":"lines","forward":true}}] - 删掉冗余命令（比如多按了一次
Enter），加一条{"command": "select_line"}可提升对起始位置的容错性
绑定快捷键时 command 和 file 必须严格小写+全路径
在 Preferences → Key Bindings 里添加快捷键，"command" 字段只能是小写的 run_macro_file，写成 RunMacroFile 或 run-macro-file 都无效；"file" 值必须完整写出 "Packages/User/add_semicolon.sublime-macro"，漏掉 Packages/User/ 或拼错大小写，Sublime 会静默失败——不报错、不提示、不执行。
常见错误现象：按下快捷键毫无反应。
- 快捷键组合含单独
Shift（如["shift+;"]）→ 不生效，推荐用["ctrl+alt+;"]或["ctrl+alt+m"] - 文件已保存但路径写成
./add_semicolon.sublime-macro→ 找不到文件 - 宏文件里用了插件命令（如
emerald_editor:toggle_comment）→ 回放时直接跳过，不报错也不执行
回放失效的真正原因不是宏坏了，而是环境不一致
宏不理解语义，只机械复现按键流。它不管当前是不是 HTML 文件、有没有装 Emmet、光标在哪一列——只认“你录的时候在哪、按了什么、顺序怎样”。所以回放失败，90% 是因为三件事没对齐：光标位置、文件类型/语法、插件启用状态。
实操建议：
- 回放前手动把光标挪到目标行首或行尾（比如录的是
End → ; → ↓，就得确保光标在行末） - 避免录依赖上下文的命令：比如
expand_selection在不同代码块行为不一致，不如录Ctrl+L（选整行）更稳定 - 正则替换中的
$1或\0在宏里当字符串处理，不会动态求值；想批量改变量名，别录查找替换，改用多重光标 +Ctrl+D更可靠
宏本质是 JSON 命令序列，不是智能脚本。能用它省三秒，就别硬扛二十遍；但它救不了逻辑判断、跨文件操作或动态文本提取——那种场景该换插件或写 Python 脚本。
