Sublime Macro 仅支持线性按键回放，无法判断、不理解上下文、不支持正则与跨行对齐；Ctrl+F等UI操作会中断录制；路径须为Packages/User/xxx.sublime-macro格式；光标错位导致回放失准；遇判断/正则/循环/跨文件/交互需求应改用Python插件。
Sublime 的 Macro 功能无法完成“复杂”的序列化文本处理任务——它根本不能做判断、不理解上下文、不支持正则、也不能跨行智能对齐。所谓“一键完成复杂任务”，实际只适用于固定起始状态下的线性按键回放。
Macro 录制时为什么 Ctrl+F 或命令面板操作会失效
因为 Macro 只记录 text_command 类原生编辑行为，所有触发 UI 面板的操作都会中断录制流：
-
Ctrl+F弹出查找框后，后续按键（如输入搜索词、按 Enter）不会被记录，录制直接终止 -
Ctrl+Shift+P打开命令面板后，任何键盘输入或方向键选择都不进宏序列 - 鼠标点击菜单栏（如
Find → Replace）、右键菜单、侧边栏操作全部无记录 - 唯一能录进去的“查找类动作”是快捷键已绑定且不弹窗的，比如
Ctrl+H（替换）——但前提是替换内容和确认动作也得用键盘完成（Tab 切换、Enter 确认），不能靠鼠标点
保存后的 .sublime-macro 文件路径写错就调用失败
路径不是“文件名”，也不是相对路径，必须是 Sublime 包系统可解析的完整资源路径：
- 正确写法：
"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"（绝对路径不被run_macro_file支持） - 验证方式：执行
Preferences → Browse Packages…，确认文件真在打开的User/文件夹里
回放时“跑偏”的真实原因：光标位置不可控
Macro 不做定位，只机械执行移动指令。一次错位，全盘错乱：
- 录制时从行末按了
End→;→↓，回放时若光标在行中，End会跳到该行末，但↓可能跳进注释块或空行 - 录制时用了
Ctrl+L（选整行），但回放时光标在单词中间，Ctrl+L仍会选中当前行——这看似合理，但如果目标是“只处理有内容的行”，它照样会选中空行并执行后续插入 - 多行操作极易失准：录制时用
Ctrl+D连续选中三个 “foo”，回放时若当前文件只有两个 “foo”，第三次Ctrl+D会失败，后续命令全部错位 - 调试建议：打开
Packages/User/xxx.sublime-macro，检查 JSON 里有没有{"command": "move_to", "args": {"to": "eol"}}这类依赖上下文的命令；替换成更鲁棒的{"command": "select_line"}可缓解部分问题
什么时候该放弃 Macro，改用 Python 插件
只要任务里出现以下任意一项，Macro 就不是解决方案，而是障眼法：
- 需要判断：“只对非空行末尾加分号”“跳过以
//开头的行” - 需要正则：“把所有
id=".*?"替换为data-id="..."” - 需要循环：“对每个选区分别执行不同逻辑”
- 需要跨文件：“把 A.js 里的函数名批量同步到 B.md 的表格中”
- 需要用户交互：“运行时弹出输入框，让用户填入前缀”
这些场景下，一个不到 15 行的 TextCommand 插件就能稳稳落地，而硬用 Macro 去凑，只会让调试成本远超开发成本。
