Sublime宏仅支持Ctrl+Q/Cmd+Q启动且需聚焦编辑区并有实际键盘操作；宏文件路径、命令名、命名格式须严格规范；回放失败多因上下文不匹配；手动编辑JSON可调试，但无法处理条件逻辑或动态内容。
Sublime 的宏不是“点一下开始录”的图形化工具，它只认 Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS）这一种启动方式；按下去没反应？大概率是焦点不在编辑区，或你根本没做任何键盘操作——空录制的宏回放必然失败。
为什么按 Ctrl+Q 没反应，状态栏也不显示 “Recording macro”
这不是 bug，而是 Sublime 对录制入口的严格限定：
- 必须聚焦在**文本编辑区**：侧边栏、命令面板（
Ctrl+Shift+P）、空标签页、查找框（Ctrl+F）里按Ctrl+Q全无效 - 按下后必须有**实际键盘动作**：光标移动（
End、↓）、输入（;）、删除（Backspace）等，纯按键不触发录制启动 - macOS 用户注意：
Cmd+Q默认退出应用，需先在系统设置中禁用，或改用Ctrl+Q并确保 Sublime 接收该组合键 - 菜单里的
Tools → Record Macro在多数版本中只是摆设，状态栏无提示即未生效
保存后快捷键不触发 run_macro_file 怎么排查
Sublime 对宏路径和命令名校验极严，错一个字符就静默失败，不报错也不提醒：
-
"command"必须小写且拼写精准：run_macro_file，写成RunMacroFile、playback_macro或run-macro-file全部无效 -
"file"值必须是完整资源路径："Packages/User/add_semicolon.sublime-macro"，不能省略Packages/User/，不能用./或绝对路径 - 文件名只能含小写字母、数字、下划线，必须以
.sublime-macro结尾；中文、空格、驼峰命名（如AddSemicolon.sublime-macro）会导致加载失败 - 保存后务必打开
Preferences → Browse Packages…，进入User/文件夹确认文件真实存在且内容为合法 JSON 数组
回放总卡在第 7 行、光标不动、只输一半字符
宏不理解语义，只复现按键流。所谓“卡住”，其实是上下文对不上：
-
Ctrl+D失效？录制时当前行有该词，回放时没有，选区扩展失败，后续所有偏移 - Tab 补全中断？录制时文件类型是
.html且 Emmet 插件启用，回放时类型不对或插件关闭，动作直接挂起 - 想删整行却只删了光标后？录制前没用
Ctrl+Home或Home归位到行首，宏只会执行“删光标后内容” - 多光标只作用于第一行？宏默认单点回放，需提前用
Ctrl+Shift+L或正则^手动置入所有目标光标位置
怎么手动编辑 .sublime-macro 文件微调行为
宏文件本质是 JSON，打开就能看、能删、能加——这是调试最直接的方式：
- 每条是形如
{"command": "insert", "args": {"characters": ";"}}的对象，全部命令必须是 Sublime 原生text_command - 可删掉冗余步骤：比如最后多余的
{"command": "move", "args": {"by": "lines", "forward": true}}，避免跳行 - 可插入确定性指令提升鲁棒性：如
{"command": "move_to", "args": {"to": "eol"}}替代模糊的End键 - 不能写插件命令（如
side_bar_files）、不能调用函数、不能读剪贴板——写了会静默失败或报错
宏的边界很清晰：它只适合线性、固定模式、上下文可控的文本操作。一旦涉及条件判断、跨文件、动态内容（如时间戳、行号），就得切到 Python 插件或外部脚本。别试图用宏绕过这个限制——它不会理解你想要的“智能”，只忠实地重演你录下的每一个按键。
