sublime宏仅记录键盘按键流，必须用ctrl+q/cmd+q启动并聚焦编辑区，录制需全程键盘操作、避免弹窗，保存路径和命令名须严格小写且完整，回放依赖光标初始位置与录制一致。
Sublime 的宏不是“点一下就录好”的图形化工具，它只认快捷键触发、只录键盘流、不理解上下文——按错一次 Ctrl+Q 或多点一下鼠标，回放就卡在第 3 行不动。
怎么启动录制才真正开始记录
别点 Tools → Record Macro，这个菜单项在多数版本里不生效。唯一可靠方式是直接按 Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS）：按下瞬间状态栏右下角闪现 Recording macro 才算启动。没看到就是白按。
- 必须聚焦编辑区——侧边栏、命令面板、空标签页里按
Ctrl+Q无效 - 录制前清空一个新文件，用键盘走一遍完整流程（比如
End→;→↓），确认节奏干净、无鼠标介入 - 中途弹出
Ctrl+F查找框、Ctrl+Shift+P命令面板、保存对话框，录制会静默中断，后面所有操作都不存
为什么保存后快捷键没反应
90% 是路径或命令名写错，且 Sublime 不报错、不提醒，直接静默失效。
-
"command"必须小写拼成run_macro_file，写成Run_Macro_File或run-macro-file都无效 -
"file"值必须是完整包路径，例如"Packages/User/add_semicolon.sublime-macro"；不能省略Packages/User/，不能用./或本地绝对路径 - 快捷键组合避免单独用
Shift，比如["shift+;"]不生效；推荐["ctrl+alt+;"]或["ctrl+alt+m"] - 保存后务必通过
Preferences → Browse Packages…打开Packages/User/文件夹，确认文件真实存在、名字全小写、无空格、无中文
回放总“跑偏”，根本原因不是宏坏了
宏不理解语义，只机械回放按键流。它不管你是 Python 还是 JSON，也不管光标在词中间还是行首，只认“你录的时候在哪、按了什么、顺序怎样”。
- 录了
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":"move_to","args":{"to":"eol"}},{"command":"insert","args":{"characters":";"}}]
你可以删冗余命令、加 {"command": "select_line"} 强制对齐上下文、复制命令块模拟“重复三次”，甚至把 move_to 改成 move 配合 {"by": "lines", "forward": true} 控制跳转行为。
- 所有命令必须是 Sublime 原生
text_command，不能调用插件命令（如side_bar_files） - 删除某条命令后，记得检查前后命令的上下文衔接，比如删掉
End后，insert可能插到行首 - 不支持剪贴板读写、跨行正则替换、条件分支——这些得靠插件或 Python API 实现
宏的本质是“精准复现按键流”，它不聪明，但足够可靠——只要你每次开始前把光标放在预期位置，每一步都用键盘完成，不碰鼠标、不弹面板，它就能稳稳跑完。最常被忽略的，是录制前没清空干扰内容、回放前没统一光标锚点、以及保存后没进 Packages/User/ 目录确认文件落地。
