ctrl+q（win/linux）或cmd+q（macos）是唯一可靠录制起点，按一次开始、再按一次停止，状态栏闪现“recording macro”即生效；录制中禁用鼠标、命令面板等非编辑操作，全程仅录键盘动作；保存路径必须为packages/user/xxx.sublime-macro，绑定快捷键须用run_macro_file命令并严格匹配大小写与正斜杠路径。
Ctrl+Q 是唯一可靠起点，不按它，后续全白搭。Sublime 的宏不是“功能模块”，而是隐式按键流捕获机制——菜单里的 Record Macro 在多数版本中已失效或响应不稳定，必须用快捷键触发。
怎么开始录制：只认 Ctrl+Q（Win/Linux）或 Cmd+Q（macOS）
按下一次进入录制，再按一次停止；状态栏右下角会闪现 Recording macro（不显眼但真实存在）。没看到这个提示，说明根本没录上。
- 别点菜单
Tools → Record Macro—— 它在 Sublime 4.4+ 中常无响应，属于历史残留项 - 录制中禁用一切非编辑行为：不能按
Ctrl+Shift+P、不能开Ctrl+F、不能切标签页、不能点侧边栏 - 全程必须用键盘：用
Home/End定位，用Ctrl+L选整行，用Ctrl+Shift+L拆行 —— 鼠标动作完全不记录 - 建议先在空白文件试录完整流程，比如
End→;→Enter，确认光标移动和输入干净再正式录
为什么保存后快捷键没反应：路径、命名、命令三处必错其一
宏文件不会报错加载失败，只会静默失效。最常见原因是 run_macro_file 命令找不到目标文件。
-
file参数必须是完整包路径："Packages/User/add_semicolon.sublime-macro"✅，"add_semicolon.sublime-macro"❌，"./add_semicolon.sublime-macro"❌ - 文件名禁用中文、空格、大小写混用：
add_semicolon.sublime-macro✅，添加分号.sublime-macro❌，clean js.sublime-macro❌ - 绑定快捷键必须用
run_macro_file，不是playback_macro—— 后者只能播内存里最后一次录制的临时宏，关掉 Sublime 就丢 - Windows 下也必须用正斜杠
/，不能用反斜杠\；大小写必须严格匹配，AddSemicolon.sublime-macro和实际文件名不一致就加载失败
怎么验证宏是否真被加载：别靠猜，用命令面板直查
保存宏后，立刻按 Ctrl+Shift+P 输入 Run Macro，回车。如果列表里没出现你的文件名，说明路径或命名已出问题。
- 打开
Preferences → Browse Packages…，确认文件真在User/目录下，且扩展名是.sublime-macro - 双击打开该文件，检查内容是否为合法 JSON 数组，例如
[{"command": "move_to", "args": {"to": "eol"}}]—— 若为空或含乱码，说明保存过程被中断 - 不要试图用外部工具运行它：.sublime-macro 不是脚本，不能双击，也不能被 Python 或 shell 调用
- 修改宏文件后无需重启 Sublime，但键位配置若有语法错误（如缺逗号、引号不闭合），整段用户快捷键会失效
Ctrl+Shift+K，删掉光标所在行。真正容易被忽略的，是起始状态一致性：每次回放前，光标必须处于和录制时相同的相对位置（比如都在某行开头），否则所有偏移都会错位。
