先按Ctrl+Q（Windows/Linux）或Cmd+Q（macOS）开始录制宏，状态栏右下角会显示“Recording macro”提示；建议先在空白文件试录完整流程，确保动作干净。
怎么开始录制宏：别等“完美操作”，先按 Ctrl+Q
Sublime 的宏不靠菜单点进“高级设置”启动，它用的是快捷键优先逻辑——Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS）就是开关。点菜单 Tools → Record Macro 也行，但容易误点成其他子项；而快捷键响应快、无歧义，且状态栏右下角会闪现 Recording macro 提示（不显眼，但真有）。
常见错误是：录之前没想清楚目标动作，边录边删改，结果宏里混入大量光标乱跳、误按 Esc 或多余 Enter。建议先在空白文件试一次完整流程，比如“把光标所在行末尾加 ; 再换行”，确认步骤干净再正式录。
- 只记录键盘行为：鼠标点击、菜单选择、右键操作一律不录
- 不记录上下文判断：比如“只对含
function的行操作”这类条件逻辑，宏做不到 - 多光标操作可录：
Ctrl+Shift+L拆行、Ctrl+D逐词选中，这些都会被转成命令序列
回放失败的三个典型原因：光标位置、命令冲突、未保存
点了 Tools → Playback Macro 却没反应？或者只动了光标没输字符？大概率掉进了这三个坑：
-
Playback Macro默认只作用于当前光标所在行/选区，不是全文批量处理——如果你录的是“删当前行”，回放时得先把光标挪到目标行首 - 某些快捷键在录制时触发了插件命令（如 Emmet 的
Tab），但回放时该插件未启用或上下文不匹配，导致动作中断 - 最常被忽略的一点：刚录完没保存就关 Sublime，宏只存在内存里，重启后彻底消失——它不像 VSCode 的 Macros 插件能自动持久化
验证是否录对，最快方法是：停止录制后立刻按 Ctrl+Shift+P，搜 Playback Macro 并执行，观察是否复现原动作。不行就重录，别试图“修”错的宏。
保存宏并绑定快捷键：路径写错就永远找不到
保存宏不是点一下“确定”就完事。Tools → Save Macro 后，文件名必须以 .sublime-macro 结尾，且默认保存路径是 Packages/User/——这个路径不能手动改错，也不能填相对路径如 ./add_semicolon.sublime-macro。
绑定快捷键时，file 参数必须严格匹配该路径。例如你存为 add_semicolon.sublime-macro，键位配置就得写：
{ "keys": ["ctrl+alt+;"], "command": "run_macro_file", "args": { "file": "Packages/User/add_semicolon.sublime-macro" } }- 路径中的
Packages/User/是固定前缀，不是你本地磁盘路径 - 文件名区分大小写，
AddSemicolon.sublime-macro和add_semicolon.sublime-macro是两个文件 - 保存后可直接在命令面板里搜文件名调用，不用非走快捷键
手动编辑宏文件：JSON 看着吓人，其实删两行就变干净
宏文件本质是 JSON 数组，打开 Packages/User/add_semicolon.sublime-macro 就能看到类似这样的结构：
[{"command": "move_to", "args": {"to": "eol"}}, {"command": "insert", "args": {"characters": ";"}}]它不像脚本语言需要语法检查，只是命令顺序列表。你完全可以手动删掉某一步（比如多余的 move）、合并连续 insert、甚至把 "forward": true 改成 false 来反向移动。
- 不要加注释：JSON 不支持
//或/* */，加了会导致宏失效 - 命令名必须准确：比如
move_to不是moveto，insert不是input - 没有延迟或循环：纯线性执行，想“每行都加引号”就得自己手动回放多次，或配合多光标先选好所有行再播放
真正难的不是写宏，而是判断哪些操作值得录——凡是你发现自己连续做了三次以上相同键盘动作，它就已经值回票价了。其他都是细节。
