Sublime Text宏仅机械重放按键流，依赖光标位置、文件类型、插件状态三者完全一致；录制必须用Ctrl+Q/Cmd+Q快捷键，禁用鼠标和面板操作；保存须为Packages/User/下以.sublime-macro结尾的文件，回放前需手动校验环境。
Sublime Text 的宏不是“录完就能用”的自动化工具，它只机械重放按键流；光标位置、文件类型、插件状态三者错一个，回放就失败。
怎么开始录制：必须用 Ctrl+Q 或 Cmd+Q，别点菜单
Tools → Record Macro 响应慢、易误点子项，且部分版本下无法触发完整录制。真正可靠的方式是：
- Windows/Linux 按
Ctrl+Q启动，再按一次停止；macOS 用Cmd+Q - 状态栏右下角会闪一下
Recording macro，没看到也不代表失败，只要没报错，大概率已在录制中 - 录制期间所有键盘操作都会被记下——包括
Ctrl+Z、Esc、多余Enter，这些全变成宏的一部分 - 鼠标拖选、右键、点击侧边栏、弹出
Ctrl+F查找框或Ctrl+Shift+P命令面板，会导致录制静默中断，后续动作全丢
为什么 Playback Macro 没反应：三个前提常被忽略
点了 Tools → Playback Macro 却只跳光标、不输字符？问题几乎都出在这三点：
- 光标不在预期位置：
delete_line是删“当前行”，你得先把光标放到目标行首，宏不会自动找行、不会批量处理 - 命令上下文丢失：比如录制时用
Tab触发 Emmet 补全，但回放时文件后缀不是.html，或 Emmet 插件被禁用，动作直接卡住 - 宏还在内存里，没保存：刚录完不执行
Save Macro就关 Sublime，宏彻底消失——它不像 VSCode 那样自动持久化
怎么保存并确保能调用：路径和后缀一个都不能错
保存不是点“确定”就完事，必须满足三个硬性条件：
- 必须走
Tools → Save Macro…（不能用普通文件保存对话框） - 文件名必须以
.sublime-macro结尾，例如wrap-in-div.sublime-macro - 必须存到
Packages/User/目录下——这个路径不能手动改，也不能填./xxx.sublime-macro或绝对路径 - 保存后可手动打开该文件，确认内容是 JSON 数组，例如
[{"command":"insert","args":{"characters":"//"}}]；你可以删掉冗余命令、插入{"command": "select_line"}提高鲁棒性
怎么绑定快捷键运行：run_macro_file 命令要写对
想用快捷键调用，必须在 Key Bindings 中添加规则，常见错误都在这里：
-
"command": "run_macro_file"必须全小写，不能写成Run_Macro_File或run-macro-file -
"file"值必须是完整包路径，例如"Packages/User/add_semicolon.sublime-macro" - 快捷键组合里避免单独
shift（如["shift+;"]无效），推荐["ctrl", "alt", "m"]这类稳定组合 - 保存后务必通过
Preferences → Browse Packages…打开User/目录，确认文件真实存在且命名正确
宏文件本质是 JSON，可手动编辑，但所有命令必须是 Sublime 原生支持的 text_command；调用插件命令（如 side_bar_files）会静默失败。凡涉及判断、正则、跨文件或批量处理，就得换插件——宏只适合线性、固定模式的键盘操作。
