Sublime宏必须通过Ctrl+Q/Cmd+Q录制并保存为.sublime-macro文件才能复用，路径、命令名、文件名任一错误均静默失效；录制需纯键盘操作，回放依赖原始光标位置与按键流，调试推荐直接编辑JSON。
Sublime 的宏不是“设置”出来的，而是靠快捷键录制 + 手动保存为 .sublime-macro 文件才能复用；不保存就关软件，宏立刻丢，且路径、命令名、文件名任一写错，快捷键就静默失效——不报错，也不提醒。
怎么开始录制才真正生效
别点菜单栏的 Tools → Record Macro，它在多数版本里只是视觉反馈，实际不触发真实录制。唯一可靠方式是直接按 Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS）：按下瞬间状态栏右下角闪现 Recording macro 才算启动。录之前建议清空一个新文件，用键盘走一遍完整流程（比如 End→;→↓），确认节奏干净、无鼠标介入。
- 录制中禁用鼠标：拖选、点击、
Ctrl+Click多光标全不记录，且会导致后续步骤错位 - 中途弹出
Ctrl+F查找框、Ctrl+Shift+P命令面板、保存对话框，录制会静默中断，后面所有操作都不存 - 全程必须用键盘定位：
Home/End、Ctrl+L选整行、Ctrl+Shift+→选词，别碰鼠标
保存后快捷键没反应？90% 是路径或命令名写错
刚录完的宏只存在内存里，关掉 Sublime 就丢。要长期用，必须立刻保存为 .sublime-macro 文件，且路径必须严丝合缝——这是最常卡住的地方。
-
"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…打开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"}确保每次操作都基于整行，提高鲁棒性 - 注意：所有命令必须是 Sublime 原生支持的
text_command，不能调用插件命令（如side_bar_files）
宏适合线性、固定步骤的任务，比如每行加引号、删空行、补分号；一旦涉及判断、正则、跨文件或上下文依赖，就得换插件——宏不会帮你思考，只忠实地重演你按下过的每一个键。
