Sublime Text宏功能默认不显示在命令面板中，仅支持快捷键调用；宏文件为JSON格式，需通过Sublime加载，不可双击运行或外部执行；路径须为res://或绝对路径；宏无法处理剪贴板、正则遍历或条件逻辑，本质是操作录像而非自动化工具。
宏录制后按 Ctrl+Shift+P 找不到“Playback Macro”？
Sublime Text 的宏功能默认不暴露为命令面板可调用项，Playback Macro 和 Start/Stop Recording Macro 只绑定快捷键，不注册进命令面板。这不是你没装插件或配置错，是原生设计如此。
解决方法只有两个：
- 记住并使用默认快捷键：
Ctrl+Q（Windows/Linux）或Cmd+Q（macOS）播放；Ctrl+Shift+Q开始/停止录制 - 手动在
Preferences → Key Bindings中添加命令面板条目（需写 JSON）：[{"keys": ["ctrl+alt+p"], "command": "run_macro_file", "args": {"file": "res://Packages/Default/Macros/Default.sublime-macro"}}]但注意：这只能播放最近一次录制的宏，不能指定多个宏文件
为什么保存的 .sublime-macro 文件双击打不开、也不能直接运行？
Sublime 的宏文件本质是 JSON 数组，记录的是按键事件序列（如 {"command": "move", "args": {"by": "lines", "forward": true}}），不是可执行脚本。它必须由 Sublime 自身加载，外部系统无法解析执行。
正确用法只有两种：
- 通过快捷键
Ctrl+Shift+Q录制 →Ctrl+Q播放（临时宏，不落地） - 录制后立刻按
Ctrl+Shift+P输入Save Macro，保存为.sublime-macro文件；之后用Tools → Macros → Run Last Recorded Macro或快捷键调用
别试图用 Python 脚本读取该文件再模拟按键——Sublime 不提供公开的宏执行 API，第三方工具无法复现其行为。
run_macro_file 命令找不到路径？路径写法有严格限制
Sublime 只认两类路径格式：
- 资源内路径：
res://Packages/Default/Macros/Emmet.sublime-macro（以res://开头，对应插件包内文件） - 绝对路径（仅限本地）：
C:/Users/name/AppData/Roaming/Sublime Text 3/Packages/User/clean_js.sublime-macro（Windows）或/Users/name/Library/Application Support/Sublime Text 3/Packages/User/format_json.sublime-macro（macOS）
常见错误：
- 用相对路径（如
./macros/my.macro）→ 报错Unable to open … - 路径含中文或空格未编码 → 加载失败且无提示
- 把宏文件放在
Packages/Default下 → 启动时被覆盖（升级 Sublime 会重置 Default 包）
宏里无法处理剪贴板内容或跨行正则替换？这是设计上限
Sublime 宏只记录「用户可见操作」：光标移动、按键输入、菜单点击、命令触发。它不捕获中间状态，也不支持条件分支或变量。
典型失效场景：
- 想“选中当前单词 → 复制 → 在另一处粘贴” → 宏会固化粘贴位置，无法动态适配新光标位置
- 想“查找所有
console.log并替换成debugger” → 宏只能录一次查找+替换动作，不会自动遍历全部匹配项（除非你手动点Replace All并把它录进去） - 想根据行首字符决定是否缩进 → 宏没有 if 判断能力
这类需求已超出宏范畴，应转向 Python 插件 或 TextCommand 扩展。宏只是快捷键组合的录像带，不是自动化引擎。
真正容易被忽略的一点：宏录制时如果误触了鼠标拖拽或意外切换了标签页，这些操作也会被完整记下——下次播放就会强制跳转、选中不可控区域。所以录制前务必清空无关视图，用键盘纯导航。
