sublime宏唯一有效录制方式是快捷键触发：windows/linux按ctrl+q，macos需禁用系统cmd+q或改用ctrl+q；必须聚焦编辑区、状态栏显示“recording macro”才算启动，且仅记录按键流，不理解语义，回放失效多因上下文变化或配置错误。
Ctrl+Q 按下就录，再按一次就停——这才是 Sublime 宏真正生效的唯一入口，菜单里的 Tools → Record Macro 在多数版本中不触发实际录制，状态栏没反应就是白录。
怎么启动录制才真正开始记录
Sublime 宏只认快捷键触发，不响应菜单点击。Windows/Linux 必须按 Ctrl+Q，macOS 是 Cmd+Q（注意：macOS 系统级 Cmd+Q 默认退出应用，需先在系统设置里禁用或改用 Ctrl+Q）。按下瞬间状态栏右下角会闪现 “Recording macro”，没看到说明根本没启动。
常见失效原因：
- 在侧边栏、命令面板或空标签页里按
Ctrl+Q—— 必须聚焦编辑区 - 按下后没做任何键盘操作（如移动、输入、删除）——宏内容为空，回放自然无效
- 中途弹出
Ctrl+F查找框或Ctrl+Shift+P命令面板 ——录制静默中断，后续动作全丢
为什么回放总卡在第 7 行不动
宏不理解语义，只复现按键流。它不管你是 Python 还是 JSON，也不管光标在词中间还是行首，只认“你录的时候在哪、按了什么、顺序怎样”。所以错位不是宏坏了，是上下文对不上。
典型现象和应对方式：
-
Ctrl+D回放失败 → 录制时当前行有该词，回放时没有，选区增扩失败，后续所有操作偏移。解决：避免依赖文本匹配，改用End→;→↓这类位置确定的操作 - Tab 触发 Emmet 补全卡住 → 回放时文件类型不是
.html或 Emmet 插件未启用。解决：只在目标类型文件中录制，或改用纯文本插入 - 光标停在行中却期望“删整行” → 实际只删光标后内容。解决：录制前统一用
Ctrl+Home或Home归位到行首
保存后快捷键没反应？90% 是路径或命令写错
宏只存在内存里，关掉 Sublime 就丢；而保存后不生效，几乎全是路径、命名或绑定配置的问题，且 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…，进User/文件夹确认文件真实存在，名字全小写、无空格、无中文
手动编辑 .sublime-macro 文件比重录高效十倍
所有 .sublime-macro 文件都是扁平 JSON，结构清晰，比如：
[{"command": "move_to", "args": {"to": "eol"}}, {"command": "insert", "args": {"characters": ";"}}]
你可以直接打开它修改，不用反复重录：
- 删掉冗余命令（比如多按了一次
↓），但要注意前后命令衔接，比如删掉move_to后，insert可能插到行首 - 插入
{"command": "select_line"}强制每次基于整行操作，提升鲁棒性 - 复制命令块模拟“重复三次”，宏本身不支持循环，但可展开
- 所有命令必须是 Sublime 原生
text_command，不能调用插件命令（如side_bar_files）
复杂点在于：宏永远不校验上下文。哪怕你把 JSON 改得再完美，只要回放时光标不在录制时的位置，或者当前行结构已变，它照样卡住——这不是 bug，是设计如此。
