sublime宏仅机械回放按键流，必须用ctrl+q/cmd+q启动录制，禁用鼠标，清空文件预演流程；保存需用小写命令名和完整包路径，快捷键避免单独shift；回放依赖与录制时完全一致的光标位置和上下文。
Sublime 的宏不是“点一下就自动化”的智能工具，它只机械回放你按下的每一个键——用对了，三秒改完二十行；录错一步，回放时光标卡在第 7 行不动，你还得手动 Ctrl+Z 撤销。
怎么启动录制才真正生效
别点 Tools → Record Macro 菜单项，它在多数版本里不触发真实录制，状态栏没反应，录了也白录。唯一可靠方式是直接按 Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS）——按下去瞬间，状态栏右下角会闪现 “Recording macro”，这才是真开始了。
- 录之前先清空当前文件，用键盘走一遍完整流程（比如
End→;→↓），确认节奏干净、无鼠标介入 - 录制中禁用鼠标：拖选、点击、
Ctrl+Click多光标全不记录，且会导致后续步骤错位 - 中途弹出
Ctrl+F查找框、Ctrl+Shift+P命令面板、保存对话框，录制会静默中断，后面所有操作都不存
保存路径和快捷键为什么总失效
宏文件只存在内存里，关掉 Sublime 就丢；而保存后快捷键没反应，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/文件夹确认文件真实存在
回放“跑偏”根本原因不是宏坏了
宏不理解语义，只复现按键流。它不关心你当前在哪一行、有没有选中文本、是不是 HTML 文件——它只认“你录的时候光标在哪、按了什么、顺序怎样”。
- 录的是
Ctrl+D高亮单词，回放时当前行没有该词，Ctrl+D就失败，后续所有动作全部错位 - 录了
Tab触发 Emmet 补全，但回放时文件类型不是html或 Emmet 插件未启用，动作就卡住 - 想每行末尾加分号，别录“选中整行→输入;”，而要录
End→;→↓，靠光标移动而非选区状态保证可复现 - 调试方法：直接打开
Packages/User/xxx.sublime-macro，看 JSON 是否含预期命令，比如{"command": "move_to", "args": {"to": "eol"}}
手动编辑宏文件比重录更高效
所有 .sublime-macro 文件都是纯 JSON，结构扁平、命令明确，改几行比重新录十遍还快。
- 可删冗余命令（比如多按了一次
↓），或插入{"command": "select_line"}强制统一上下文 - 复制粘贴命令块，实现“重复三次”效果（宏本身不支持循环，但可展开）
- 把
move_to改成move并配{"by": "lines", "forward": true}控制跳转行为 - 注意：所有命令必须是 Sublime 原生
text_command，不能调用插件命令（如side_bar_files）
最常被忽略的点是：宏的可靠性不取决于你录得多快，而取决于你每次回放前，是否把光标放在和录制时一模一样的位置——它不聪明，但足够准；你给它确定的起点，它就还你确定的结果。
