Sublime Macro 仅适用于起始状态完全一致、操作路径绝对固定的线性流程；它无法判断括号、跨行对齐、条件替换或正则捕获组，不支持多光标遍历、相对路径宏调用及动态逻辑判断，复杂任务需改用原生命令或Python插件。
Sublime 的 Macro 功能根本不能“一键完成复杂格式的批量转换”——它连“判断是否存在括号”都做不到，更别说跨行对齐、条件替换或正则捕获组处理。所谓“复杂”，实际只适用于起始状态完全一致、操作路径绝对固定的线性流程。
Ctrl+Q 录制后宏不生效，大概率没真正录上
Tools → Record Macro 菜单项在 Sublime 4.4+ 中基本失效，必须用快捷键触发：Windows/Linux 按 Ctrl+Q 开始，再按一次停止；macOS 是 Cmd+Q。状态栏右下角会闪现 Recording macro，没看到就等于没录——后续所有操作都不进序列。
- 录制中一旦按下
Ctrl+F、Ctrl+Shift+P或鼠标点击侧边栏，录制立即中断，生成的宏文件可能为空或含非法命令（如"command": "show_panel"） - 打字输入（比如敲
console.log()）不会被记录为字符流，只会记成insert命令，且默认不带args.characters，回放时啥也不输 - 试录建议：在空白文件里做
End→;→Enter，保存后用命令面板搜Run Macro确认能否调出文件名
run_macro_file 找不到宏文件，90% 是路径写错
Sublime 不支持相对路径或绝对路径，run_macro_file 的 file 参数必须是包系统可解析的完整资源路径，且大小写、斜杠方向、扩展名全部敏感。
- 正确写法：
"file": "Packages/User/add_semicolon.sublime-macro" - 错误写法：
"file": "add_semicolon.sublime-macro"（缺包路径）、"file": "./User/add_semicolon.sublime-macro"（点斜杠无效）、"file": "Packages/user/add_semicolon.sublime-macro"（user小写不匹配） - 验证方式：执行
Preferences → Browse Packages…，确认文件真在打开的User/文件夹里，且双击打开后内容是合法 JSON 数组，形如[{"command": "move_to", "args": {"to": "eol"}}]
多行批量处理失败，因为宏默认只作用于当前光标
哪怕你用 Ctrl+Shift+L 选中 20 行，运行宏也只在第一个光标位置执行一次。宏没有遍历逻辑，它不理解“选区”是多个位置。
- 临时解法：先用多光标定位到每行开头（比如
Ctrl+Shift+↓或正则选中^后按Ctrl+Shift+L），再确保宏以相对移动为主（如move_to+{"to": "eol"}），避免依赖绝对坐标 - 可靠替代：装
MultiEditUtils插件，选中多行后Ctrl+Shift+P→MultiEdit: Run Command on Each Selection，指定插入或替换动作，稳定性远高于宏 - 别指望宏做“查找所有
foo并替换为bar”——它只能录下你手动点Ctrl+H→ 输正则 → 按Alt+Enter的按键流，版本一升级或界面设置一变，tab键跳错字段就全崩
想做大小写转换、正则替换、智能包裹，别硬套宏
内置快捷键和原生命令比宏更稳：大小写用 Ctrl+K+Ctrl+U / Ctrl+K+Ctrl+L；正则替换直接用 Ctrl+H 勾选 .*，Replace With 写 \U$0\E 或 \u$0；包裹标签用 Ctrl+Shift+P → Emmet: Wrap with Abbreviation。
- 宏无法处理“如果本行有
function关键字，则在开头加//，否则跳过”这类逻辑——它既不读上下文，也不做分支 - 需要动态行为（如根据光标所在列插入不同缩进、跨文件同步修改）必须写 Python 插件，用
sublime_plugin.TextCommand获取self.view.sel()和self.view.line(region)手动控制 - 一个常见错觉：把“复杂”等同于“步骤多”。但 Macro 的脆弱性不在步骤数量，而在任何一步光标偏移（比如录制时
Ctrl+D选了 3 个词，回放时只剩 2 个，第三次Ctrl+D失败，后续全错位）
Macro 的适用边界很窄：固定起始光标、无交互弹窗、无 UI 面板介入、无跨行依赖、无判断需求。一旦任务里出现“可能”“如果”“查找后替换”“对齐到某列”，就得切到 Python 插件或原生命令组合——不是功能不够强，而是设计上就拒绝理解语义。
