Sublime Text宏录制需用Ctrl+Q/Cmd+Q快捷键触发，仅编辑区有效且须有实际编辑操作；保存为Packages/User/目录下.json格式的.sublime-macro文件，命名限小写字母、数字和下划线；调用靠命令面板或快捷键绑定run_macro_file命令。
宏录制功能在哪找，为什么按了没反应
Sublime Text 的宏录制不是默认开启的“按钮式”功能，它靠快捷键触发，且只在有编辑行为时才开始记录。常见现象是：按下 Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS）后毫无反应——其实它已开始录制，但界面不提示；再按一次才停止并回放。如果中途没做任何编辑操作（比如光标移动、输入、删除），录制内容为空，回放自然无效。
- 必须先聚焦到编辑区（不能在侧边栏或命令面板里按）
- 录制期间至少要执行一个可被记录的操作，如
right_arrow、insert、ctrl+shift+k（删除行） - macOS 用户注意：
Cmd+Q默认是「退出 Sublime」，需先在系统设置里改掉全局快捷键，或改用Ctrl+Q
保存宏后怎么调用，路径和命名有什么讲究
宏本质是 JSON 格式的动作序列，保存路径直接影响能否被正确加载。Sublime 不会自动扫描任意位置的文件，必须放在 Packages/User/ 目录下，且后缀为 .sublime-macro。名字不能含空格或特殊符号（如 my macro.sublime-macro 会加载失败），推荐全小写加下划线。
- 手动保存路径示例：
Packages/User/format_json.sublime-macro - 保存后需重启 Sublime 或执行
Preferences → Browse Packages…刷新缓存，否则新宏不显示在命令面板 - 调用方式只有两种：命令面板搜
Run Macro，或绑定快捷键到run_macro_file命令，参数填相对路径：{"file": "Packages/User/format_json.sublime-macro"}
宏里不能做什么，哪些操作会导致回放失败
宏只记录按键和内置命令的调用，不记录鼠标位置、文件切换、弹窗交互或插件 UI 操作。一旦回放时环境与录制时不一致（比如当前文件类型不同、光标不在预期位置、目标行已被修改），就容易卡住或出错。
- 绝对避免录制：鼠标点击、右键菜单、命令面板输入文字、切换标签页
-
find_next、replace类命令依赖当前搜索状态，录制前必须先手动设好查找内容，否则回放时可能找不到 - 涉及多行选中的操作（如
expand_selection）对光标初始位置敏感，建议录制前先用home或ctrl+home统一归位 - 插件命令（如
emerald_editor:toggle_comment）能录，但要求插件已启用且上下文兼容，否则回放直接静默跳过
想让宏更可靠，绕不开的两个配置项
Sublime 宏默认不校验上下文，导致很多“看似能用”的宏在真实项目中频繁失效。真正提升稳定性的关键，是主动控制执行条件和容错逻辑，而这依赖两个隐藏但有效的配置项：context 和 fail_on_error。
- 在宏 JSON 文件里加
"context": [{"key": "selector", "operator": "equal", "operand": "source.js"}]，可限定只在 JavaScript 文件中运行 - 加
"fail_on_error": false后，遇到无法执行的步骤（如某行不存在）不会中断，而是跳过继续 - 注意：这两个字段必须写在宏数组最外层，不是每个动作对象里；Sublime 不报错，但写错位置就完全不生效
宏不是万能自动化，它适合固定结构的文本转换（如日志格式清洗、模板代码补全），但遇到动态内容、跨文件操作或需要判断逻辑的场景，就得切到 Python 插件或外部脚本。这点容易被忽略，直到卡在第十次重复操作时才意识到——宏只是快捷键的延展，不是流程引擎。
