Sublime宏本质是键序列复现，不理解语义，光标位置和文本一致性决定回放成败；解决需统一光标起点、用查找锚定、严格路径与命名、避免依赖选区和智能判断。
Ctrl+Q 录制后回放光标乱跳，根本不是宏坏了
Sublime 的宏不理解“当前行”“选中内容”或“文件类型”，它只复现你按下的键序列。录的时候光标在行首，回放时却停在中间，End就跳到该行末尾而非整行末，↓可能直接进注释块——这不是 bug，是设计如此。
常见错位场景：
- 录制时用鼠标点过某处，宏里没记录位置变化，回放时光标还在原地，后续
Ctrl+D找不到目标词 - 多行编辑前用了
Ctrl+Shift+L拆分选区，但录制时选区跨了 5 行，回放时只剩 2 行有匹配文本，第三次Ctrl+D失败，后面所有命令全偏移 - 用
Ctrl+Alt+↑/↓插入垂直多光标，但录制时按的是Ctrl+Alt+↓，回放时如果光标已在最后一行，动作就卡住不动
解决办法：每次录制前，先用 Ctrl+Home 把光标拉到文件开头；处理多行任务时，统一用 Ctrl+A → Ctrl+Shift+L 起手，避免依赖鼠标选区。
Ctrl+D 多选类操作能录，但必须保证上下文稳定
Ctrl+D 是唯一能进宏的多光标触发方式，但它极度依赖文本一致性。录的时候有 4 个 foo，回放时只剩 2 个，第三次 Ctrl+D 就失败，后续插入、删除全错位。
实操建议：
- 别录“先选中 foo → Ctrl+D → 输入 bar”，改录“
Ctrl+F→ 输入foo→Enter→Esc→Ctrl+D→bar”，用查找锚定位置 - 批量改变量名时，优先用
Alt+F3全选所有匹配项（它比连按Ctrl+D更稳），但注意：Alt+F3必须在查找面板关闭后执行，否则宏里会混入面板操作导致中断 - 如果目标词带空格或特殊字符，录之前先确认当前文件启用了正则查找，否则
Ctrl+F找不到，整个流程就断在第一步
保存为 .sublime-macro 后快捷键无效？90% 是路径写错了
宏文件只在 Packages/User/ 目录下才被识别，写成 ./add_semicolon.sublime-macro 或 user/add_semicolon.sublime-macro 都静默失败，Sublime 不报错也不提示。
绑定快捷键必须满足三件事：
-
"command"字段只能是小写run_macro_file，写成RunMacroFile或run-macro-file全无效 -
"file"值必须是完整路径："Packages/User/add_semicolon.sublime-macro"，缺一不可 - 快捷键组合避开系统拦截：macOS 上
cmd+alt+;常被系统吞掉，改用ctrl+alt+;更可靠
验证是否生效：按 Ctrl+Shift+P 输入 Run Macro，如果列表里没出现你的文件名，就是路径或命名问题——立刻打开 Preferences → Browse Packages… 进 User/ 文件夹，确认文件真实存在且后缀是 .sublime-macro。
想每行末尾加分号？别录“选中→输入”，要录光标移动流
靠选区操作（比如 Ctrl+L 选整行再输入 ;）回放极不稳定：光标不在行首时，Ctrl+L 只选光标后部分；空行里 Ctrl+L 会选中换行符，; 就插在空行中间。
真正可复用的录制方式是：
-
End→;→↓：不依赖选区，只靠光标位置推进 - 如果要跳过空行，不能录“判断空行→跳过”，而要录
End→↑→↓组合试探，或提前用Ctrl+Shift+F正则删空行再统一处理 - 处理 JSON 或配置文件时，
End可能停在右括号后，此时需加←微调，但要注意←次数必须固定，否则在不同长度行上偏移
宏的本质是机械复现，不是逻辑脚本。越依赖光标绝对位置和固定步长，越容易跑偏；越试图让它“智能判断”，越快撞墙。
