宏文件必须存于packages/user/目录并以.sublime-macro为后缀，快捷键需手动在key bindings中配置run_macro_file命令及准确路径，且宏仅支持固定按键回放，不支持交互操作或跨功能流程。
宏文件必须放在 Packages/User/ 目录下才能被识别
Sublime Text 不会自动加载任意位置的 .sublime-macro 文件。你录完宏、保存时如果路径选错，快捷键就永远触发不了——它根本找不到这个宏。
实操建议：
- 录完宏后，用
File → Save As…，手动导航到Packages/User/（可通过Preferences → Browse Packages…快速打开该目录） - 文件名建议用英文+下划线，比如
toggle_comment_and_save.sublime-macro，避免空格或中文 - 别存成
.json或直接丢在桌面——Sublime 只认.sublime-macro后缀且只扫User/和插件自带的宏目录
快捷键绑定写在 Preferences → Key Bindings 里，不是菜单里点点就行
很多人以为“宏录完就有快捷键了”，其实 Sublime 默认不给任何宏配快捷键。你得自己编辑 Key Bindings 文件，手动加一条规则。
常见错误现象：按了快捷键没反应，或者弹出“command not found”错误提示 macro: toggle_comment_and_save —— 这说明名字拼错了，或宏文件根本没加载。
实操建议：
- 打开
Preferences → Key Bindings，在右侧用户配置区（右半边）添加一行，比如：[{"keys": ["ctrl+alt+s"], "command": "run_macro_file", "args": {"file": "Packages/User/toggle_comment_and_save.sublime-macro"}}] -
command固定是run_macro_file，不能写成run_macro或漏掉_file -
file路径必须以Packages/开头，且大小写严格匹配实际文件名（macOS/Linux 区分大小写） - 快捷键别和已有命令冲突，比如
ctrl+s是保存，ctrl+shift+p是命令面板——优先用带alt或super的组合
宏里不能执行需要交互的操作，比如“保存为…”或“跳转到行号”
Sublime 的宏本质是回放按键序列，它不理解上下文。如果你在录制时点了“File → Save As…”，宏重放时只会模拟那个点击动作，但不会弹出对话框——因为宏无法处理异步弹窗或等待用户输入。
使用场景限制很明确：适合纯编辑流，比如“选中→注释→缩进→移动光标”。一旦涉及文件系统操作（另存为、打开文件）、弹窗（查找替换面板）、或依赖当前光标位置以外的状态（如“上一个折叠区域”），宏大概率失效。
实操建议：
- 录制前先关闭所有面板（查找、终端、侧边栏），确保操作流干净
- 避免用鼠标点击菜单项，改用对应快捷键（比如用
ctrl+/注释，而不是点菜单里的“Toggle Comment”） - 想实现“保存并退出”这类跨功能操作？别硬塞进宏——用插件（如
Terminus或自定义sublime-plugin）更可靠
Mac 上 command 键要写成 super，Windows/Linux 用 ctrl，别混用
快捷键配置里的修饰键名称是平台无关的抽象词：super 指 Mac 的 ⌘ 键，ctrl 指 Windows/Linux 的 Ctrl 键。写反了会导致快捷键在某个系统上完全无效。
性能影响倒没有，但兼容性直接归零。比如你在 Mac 上写了 "keys": ["ctrl+alt+k"]，那这个组合在 Mac 上实际触发的是 Ctrl+Option+K，而不是你想要的 ⌘+Option+K。
实操建议：
- Mac 用户统一用
super，例如["super+alt+k"]；Win/Linux 用户用ctrl，例如["ctrl+alt+k"] - 不想维护两套配置？可以只用跨平台安全键位，比如
["alt+shift+f"]，它在所有系统上都是 Alt+Shift+F，无歧义 - 不确定某键对应什么名？打开
Tools → Developer → Show Console，按一下键，看日志里输出的key字段值
