sublime text 宏无真正录制功能，需手动保存为packages/user/xxx.sublime-macro并用run_macro_file调用；录制失败多因焦点错误、无有效操作或macos系统快捷键冲突；回放异常源于上下文不匹配，稳定宏需手动编辑json优化。
Sublime Text 没有真正意义上的“录制宏”功能，所谓录制只是隐式捕获键盘编辑命令流；能稳定用的宏必须手动保存为 Packages/User/xxx.sublime-macro 文件，并通过 run_macro_file 调用——菜单里的 Tools → Record Macro 多数版本中不生效，别信。
Ctrl+Q 录制没反应？先看焦点和按键是否合规
按下 Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS）后状态栏没出现 “Recording macro”，说明根本没启动。常见原因：
- 焦点不在文本编辑区：侧边栏、空标签页、查找框（
Ctrl+F）、命令面板（Ctrl+Shift+P）里按Ctrl+Q全无效 - 按下后没做任何键盘操作：光标移动（
End、↓）、输入（;）、删除（Backspace）等才算触发记录；纯按键不产生动作，录制会静默失败 - macOS 用户未禁用系统级
Cmd+Q：它默认退出应用，需在系统设置中关闭全局快捷键，或改用Ctrl+Q并确保 Sublime 接收该组合键
保存后快捷键不触发 run_macro_file 怎么排查
宏文件存在但绑定快捷键无反应，90% 是路径、命名或命令名写错，Sublime 不报错，只沉默忽略：
-
"command"必须严格小写且拼写精准：run_macro_file，写成RunMacroFile、playback_macro或run-macro-file全部无效 -
"file"值必须是完整资源路径："Packages/User/add_semicolon.sublime-macro"，不能省略Packages/User/，不能用./、user/或绝对路径 - 文件名只能含小写字母、数字、下划线，必须以
.sublime-macro结尾；AddSemicolon.sublime-macro和add_semicolon.sublime-macro是两个不同文件，大小写敏感 - 保存后务必打开
Preferences → Browse Packages…，确认文件真实落在User/目录下，内容是合法 JSON 数组（如[{"command":"insert","args":{"characters":";"}}]）
回放卡住、光标不动、只输一半？本质是上下文不匹配
宏不理解语义，只复现按键流。所谓“卡住”，其实是起始位置或环境变了：
-
Ctrl+D失效？录制时当前行有该词，回放时没有，选区扩展失败，后续所有偏移全错位 - Tab 补全中断？录制时文件类型是
.html且 Emmet 插件启用，回放时类型不对或插件关闭，动作直接挂起 - 想删整行却只删了光标后？录制前没用
Ctrl+Home或Home归位到行首，宏只会执行“删光标后内容” - 多行处理失效？宏默认单点回放；哪怕你用
Ctrl+Shift+L选了 10 行，运行宏也只在第一个光标处执行一次
手动编辑 .sublime-macro 文件比依赖录制更可靠
录制只是起点，真正稳定的宏往往要手动调整 JSON：
- 删掉冗余命令：比如录制中误按了
Esc或多余Enter，它们会固化进 JSON，回放时照样执行 - 插入上下文对齐指令：在开头加
{"command":"move_to","args":{"to":"bof"}}强制跳到文件开头，避免依赖起始位置 - 替换绝对定位为相对移动：把
move_to+{"to":"eol"}改成move+{"by":"lines","forward":true}提高跨行鲁棒性 - 不能加条件或循环：JSON 里没法写 if 或 for；需要批量处理多行，优先考虑插件（如 MultiEditUtils 的
Run Command on Each Selection）
宏的边界很清晰：它不是脚本，不读剪贴板、不跑正则、不调插件命令、不判断逻辑。能用好，靠的是每次开始前把光标放在预期位置，全程用键盘完成，不碰鼠标、不弹面板、不切上下文——它不聪明，但足够机械可靠。
