Sublime Text宏仅记录text_command类编辑命令，不支持UI操作、逻辑判断和输入法上屏；录制空操作、光标位置偏差、多选错位及路径错误是回放失败主因。
Sublime Text 的宏功能不能“录制屏幕行为”，它只记录你手动触发的编辑命令序列；所有声称“一键录制”的说法，都忽略了它不支持 UI 操作、无逻辑判断、光标位置强依赖等硬限制——用错场景，回放必失败。
为什么 Ctrl+Q 录制后没反应，或回放完全跑偏
根本原因不是快捷键失效，而是 Sublime 的宏机制对上下文极度敏感：
- 录制时没做任何编辑操作（比如只按了
End或↓），record_macro会记下空序列，回放自然无声无息 - 光标起始位置不对：录制时从行末开始按
End→;→↓，回放时光标在行中，End跳到该行末，↓就可能跳进注释或空行 -
Ctrl+D多选类操作极易错位：录制时选中 4 个foo，回放时只剩 2 个，第三次Ctrl+D失败，后续所有命令全部偏移 - UI 类快捷键如
Ctrl+F、Ctrl+Shift+P、鼠标点菜单，一律不被记录——它们触发的是面板，不是text_command
哪些操作能录、哪些绝对不能录
宏只接受 Sublime 原生的 text_command 类行为，不经过 UI 层。能录的包括：
-
insert（插入字符）、move（光标移动）、toggle_comment（注释切换） -
delete_line、split_selection_into_lines、select_all - 已绑定且不弹窗的快捷键：如
Ctrl+H（替换），但必须用Tab切换、Enter确认，不能点按钮
以下操作**完全无法录制**：
-
Ctrl+F/Ctrl+Shift+F（弹出查找框，中断录制流） - 右键菜单、侧边栏拖拽、鼠标点击 Find → Replace
- 输入法上屏文字（打字本身不被记录，得靠
insert命令显式写{"characters": "console.log()"}） - 任何需要判断的场景：比如“只处理非空行”“跳过注释块”“跨行对齐”
保存和调用宏时路径写错就静默失败
Sublime 只认包系统路径，不是文件系统路径。错误写法会导致 run_macro_file 完全不执行，也不报错：
- ✅ 正确：
"file": "Packages/User/add_semicolon.sublime-macro" - ❌ 错误：
"file": "add_semicolon.sublime-macro"（没包路径，找不到） - ❌ 错误：
"file": "./User/add_semicolon.sublime-macro"（.和/在包路径中无效） - ❌ 错误：
"file": "/home/you/Packages/User/xxx.sublime-macro"（绝对路径不被支持）
验证方式：执行 Preferences → Browse Packages…，确认文件真在打开的 User/ 文件夹里；再检查键绑定中 run_macro_file 的 file 字段是否与之完全一致。
回放失准时怎么快速定位问题
别猜，直接看宏文件内容。用 Preferences → Browse Packages… 打开 User/，用 Sublime 自己打开那个 .sublime-macro 文件——它本质是 JSON 数组，每项是一个命令对象：
- 删掉明显冗余的
move或重复insert，合并连续插入可减少错位风险 - 把
{"command": "move", "args": {"by": "lines", "forward": true}}改成更稳定的定位方式，比如先select_line再move_to行尾 - 发现某步总失败？临时注释掉它，分段测试：先录前半段→保存→回放→再加后半段
最常被忽略的一点：宏没有“重置光标”能力。一旦某次回放因光标错位导致失败，后续所有调用都会继承这个偏移状态——所以每次调用前，务必手动把光标放到预期起始位置，别指望宏自己“找回来”。
