应直接按Ctrl+Q（Win/Linux）或Cmd+Q（macOS）开始录制，而非通过菜单；状态栏右下角会显示“Recording macro”，再按一次即停止。
怎么开始录制：别点菜单，直接按 Ctrl+Q（Win/Linux）或 Cmd+Q（macOS）
Sublime Text 的宏不是靠“Tools → Record Macro”菜单启动的——那个入口存在，但容易误点子菜单、响应慢、且不显示状态。真正可靠的方式是快捷键：Ctrl+Q 按下即录，再按一次即停，状态栏右下角会闪出 Recording macro（不显眼，但真有）。
常见错误现象：
- 点了菜单却没反应：可能误点了
Record Mouse Macro（不存在）或插件同名项 - 录完回放光标乱跳：录制时用了鼠标点击，而宏根本不记录鼠标行为
- 回放只输字符不换行：录制时按了
Enter，但光标不在行尾，导致插入位置偏移
实操建议：
- 先在空白文件试一次完整流程，比如
End→;→↓，确认动作干净再正式录 - 全程用键盘定位：用
Home/End、Ctrl+←/→，不用鼠标拖选 - 避免触发中断操作：
Ctrl+F、Ctrl+Shift+P、保存、关文件都会让录制意外终止
为什么回放没效果：光标位置、命令冲突、没保存这三件事最常被忽略
点了 Tools → Playback Macro 或按 Ctrl+Shift+Q 却没反应？大概率掉进了这三个坑里。
常见错误现象：
- 只动了光标，没输任何字符：回放时光标不在你录制时的起始位置（比如录制时在行首，回放时在行中）
- 部分动作执行了，后面卡住：录制时用了 Emmet 的
Tab补全，但回放时当前语法不支持或插件未启用 - 重启 Sublime 后宏消失：刚录完没存，宏只存在内存里，关掉就丢
实操建议：
- 回放前手动把光标挪到目标行/目标列——宏不判断上下文，只机械复现
- 录制时尽量用原生命令：比如用
Ctrl+L选整行，别依赖插件的“Select Line”按钮 - 停止录制后立刻按
Ctrl+Shift+P输入Save Macro，别等“回头再存”
保存宏和绑定快捷键：路径必须写全 Packages/User/xxx.sublime-macro
保存不是点“确定”就完事。路径写错、后缀漏掉、大小写不一致，都会导致快捷键失效或命令面板找不到文件。
常见错误现象：
- 快捷键按下没反应：键位配置里
file值写成add_semicolon.sublime-macro或./add_semicolon.sublime-macro - 命令面板搜不到宏：文件存在，但后缀是
.json或.macro，必须是.sublime-macro - Mac 上绑了
cmd+alt+;却触发系统快捷键：macOS 默认拦截分号组合，建议改用ctrl+alt+;
实操建议：
- 保存时默认路径就是
Packages/User/，别手动改——可通过Preferences → Browse Packages…打开该目录验证 - 键位配置严格按这个格式写：
{ "keys": ["ctrl+alt+;"], "command": "run_macro_file", "args": { "file": "Packages/User/add_semicolon.sublime-macro" } } - 文件名全部小写，避免
AddSemicolon.sublime-macro这类命名，不同系统对大小写敏感度不同
宏文件能手动编辑：打开 Packages/User/xxx.sublime-macro 就是 JSON
宏不是黑盒，它本质是一个 JSON 数组，每项是一个 {"command": "...", "args": {...}} 结构。你可以删冗余步骤、调顺序、加 select_line 提高鲁棒性。
常见使用场景：
- 想让“末尾加分号”作用于整行而非当前光标位置：在开头加
{"command": "select_line"} - 录多了撤销步骤（
undo）：直接删掉对应那行 JSON - 需要重复三次：复制粘贴三遍同一组命令（宏本身不支持循环，但可以展开）
注意限制：
- 所有
command必须是 Sublime 原生支持的text_command，不能写emmet_expand_abbreviation这类插件命令 - 不能加条件判断或正则匹配——那是
Find & Replace或插件的事，宏只做线性回放 - 多光标操作可录（如
Ctrl+D），但回放时若当前文档不满足多选条件，行为不可预测
最容易被忽略的点是：宏不保存上下文，也不校验环境。它只相信你录下的每一下按键。所以“录得准”比“修得巧”重要得多——宁可重录三次，也别试图在 JSON 里硬凑一个本不该存在的逻辑。
