Sublime Text宏仅机械回放键盘操作，不支持智能判断；必须纯键盘录制、严守路径命名规范、多光标需手动预置、正则替换应改用插件或快捷键替代。
Sublime Text 的宏不是“录完就能批量处理”的智能工具，它只机械回放你按下的每一个键——光标位置错一位、文件类型不对、插件没启用，宏就卡住或静默失败。想靠它处理复杂文本，必须绕开 UI 操作、严守键盘路径、手动校验 JSON。
怎么用 Ctrl+Q 录制一个真正可用的宏
别点菜单，直接按 Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS），状态栏右下角闪现 “Recording macro” 才算真正启动。录制中所有按键都会被记下，包括误按的 Esc、多余的 Enter、甚至 Ctrl+Z —— 这些全会变成宏的一部分。
- 全程只用键盘：用
Ctrl+L选整行、Ctrl+Shift+L拆多行、Home/End定位，鼠标拖选完全无效 - 禁止触发任何面板：按
Ctrl+F、Ctrl+Shift+P、Ctrl+K, B会中断录制，后续操作全丢 - 录制前先在空白文件试跑一次完整流程，比如
End→;→↓，确认节奏干净、无意外跳转
为什么保存后快捷键不生效
90% 的失败源于路径或命令名写错，且 Sublime 不报错，只静默忽略。
-
command必须是小写run_macro_file，写成RunMacroFile或playback_macro都无效 -
file值必须是完整包路径："Packages/User/add_semicolon.sublime-macro"—— 少一个字母、多一个空格、漏掉Packages/User/前缀，全都不加载 - 文件名不能含中文、空格、特殊符号；扩展名必须严格为
.sublime-macro - 保存后按
Ctrl+Shift+P输入Run Macro，如果列表里没出现你的文件名，说明路径或命名已出错
如何让宏作用于多行而不是只当前光标
宏默认只在当前光标位置执行一次，哪怕你用 Ctrl+Shift+L 选了 20 行，回放也只影响第一个光标。
- 先用多光标定位：比如每行开头按
Ctrl+Shift+↓，或正则选中^后按Ctrl+Shift+L，确保光标落在所有目标行首 - 宏内部尽量用相对移动指令，比如
{"command": "move_to", "args": {"to": "eol"}}，避免依赖绝对坐标 - 更可靠的方式是放弃宏，改用插件：装
MultiEditUtils后，选中多行 →Ctrl+Shift+P→ 输入MultiEdit: Run Command on Each Selection→ 选insert_snippet或自定义命令
为什么正则替换在宏里总不生效
宏不能“理解”正则，它只能录下你点开替换面板、勾选 .*、输表达式、点“全部替换”的整个 UI 流程——而这些操作跨版本极易失效。
- 别录
Ctrl+H→ 点勾选框 → 手动填正则 → 点按钮，这种流程在 Sublime 4 里可能因界面调整彻底失效 - 短期方案：用
Ctrl+H手动打开替换面板 → 勾选正则 →Alt+Enter全部替换 → 再录制，但仅限当前会话 - 长期方案：把正则逻辑写成 Python 插件命令，或直接用
Ctrl+Shift+H（替换全部）配合Ctrl+Alt+Enter（在所有打开文件中替换）
宏的本质是 JSON 数组，不是脚本。它不支持变量、循环、条件判断，也不能读剪贴板、跨文件操作或调用插件命令。真正复杂的文本处理，得靠 Python API 或成熟插件——宏只适合线性、固定、上下文可控的机械动作，比如“每行末尾加 ;”或“删空行”。想让它稳定工作，关键不是录得多快，而是每次回放前，你是否把光标放在了它唯一认得的那个位置。
