Ctrl+Q录制宏需确保状态栏显示“Recording macro”才算启动；录制失败主因是路径、命名、命令名不匹配；多行处理需多光标或插件；宏文件可手动编辑但须严格遵循原生命令规范。
Ctrl+Q 录制宏为什么没反应
根本原因是没真正启动录制——Tools → Record Macro 菜单项在 Sublime 4.4+ 中基本失效，视觉反馈不等于实际记录。唯一可靠方式是直接按 Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS），状态栏右下角闪现 Recording macro 才算开始。
- 录制中弹出
Ctrl+F查找框、Ctrl+Shift+P命令面板、保存对话框，录制会静默中断，后续动作全丢 - 鼠标拖选、点击侧边栏、切换标签页，这些操作不会被记录，且会导致光标位置错位
- 打字输入（如敲
console.log()）只记为insert命令，默认无args.characters，回放时啥也不输 - 试录建议：在空白文件里走一遍
End→;→↓，停止后立刻用命令面板搜Run Macro验证
保存的 .sublime-macro 文件为什么调用失败
Sublime 不报错，只静默失败。90% 的问题卡在路径、命名、命令名三处硬性匹配上。
-
file参数必须写完整包路径："Packages/User/add_semicolon.sublime-macro"✅，不能是"add_semicolon.sublime-macro"❌ 或"./User/add_semicolon.sublime-macro"❌ - 文件名必须以
.sublime-macro结尾，大小写敏感：AddSemicolon.sublime-macro和add_semicolon.sublime-macro是两个文件 -
command必须小写拼成run_macro_file，写成RunMacroFile或run-macro-file都无效 - 快捷键组合避免单独用
Shift，比如["shift+;"]不生效；推荐["ctrl+alt+;"]或["ctrl+alt+m"] - 验证方式：执行
Preferences → Browse Packages…，确认文件真在打开的User/文件夹里，且双击打开后内容是合法 JSON 数组
多行批量处理为什么只在第一行生效
宏默认是单点回放，不是批量处理器。哪怕你用 Ctrl+Shift+L 选中了 20 行，run_macro_file 也只在第一个光标位置执行一次。
- 临时解法：先用键盘布设多光标——比如正则选中
^后按Ctrl+Shift+L，确保每个光标都在行首，再运行以move_to+{"to": "eol"}为主的宏 - 别录“选中整行→输入;”，而要录
End→;→↓，靠光标移动而非选区状态保证可复现 - 可靠替代：装
MultiEditUtils插件，选中多行后Ctrl+Shift+P→MultiEdit: Run Command on Each Selection - 宏不理解语义，它连自己录的是 Python 还是 Markdown 都不知道，更别说判断括号或跨行对齐
宏文件能手动编辑吗？怎么改才安全
可以，但必须严格遵循 Sublime 原生命令规范。打开 Packages/User/xxx.sublime-macro，你会看到类似这样的 JSON：
[{"command":"move_to","args":{"to":"eol"}},{"command":"insert","args":{"characters":";"}}]
- 删掉冗余命令，比如去掉最后的
↓，让它不自动跳行 - 插入
{"command": "select_line"}确保每次操作都基于整行，提高鲁棒性 - 复制粘贴命令块可实现“重复三次”效果（宏本身不支持循环，但可展开）
- 所有命令必须是 Sublime 原生
text_command，不能调用插件命令（如side_bar_files） - 改完后务必验证：保存文件，再通过命令面板调用，观察是否仍按预期执行
