Sublime宏需手动录制并保存为.sublime-macro文件才能复用；录制仅支持快捷键Ctrl+Q/Cmd+Q，全程禁用鼠标及部分快捷键，保存路径、命令名和斜杠格式须严格规范，宏回放依赖精确上下文。
说到Sublime Text的宏功能，有个常见的误解需要先澄清：它不像插件那样有一份现成的“常用宏命令”列表。实际上，每一个宏都得你亲自动手录制，而且它只忠实记录你在特定上下文下的操作。想下次还能用？那就必须把它保存成一个独立的 .sublime-macro 文件。
怎么开始录制：必须按快捷键，别点菜单
启动录制的正确姿势是按下 Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS），再按一次则停止。注意看状态栏右下角，如果闪过 Recording macro 的提示，就说明录制开始了，没看到的话，要么是没录上，要么就是已经结束了。
- 这里有个坑：通过菜单栏的 Tools → Record Macro 来操作，在多数Sublime版本里其实并不稳定，依赖快捷键才是正解。
- 一旦开始录制，鼠标操作、呼出命令面板（
Ctrl+Shift+P）、查找（Ctrl+F）、点按侧边栏或切换标签页这些动作，要么会被录成无效指令，要么直接导致录制中断，必须全程禁用。 - 整个过程只能依靠键盘：用
Home/End跳转行首行尾，用Ctrl+L选中整行，用Ctrl+Shift+L拆分多行选区。总之，忘掉鼠标拖动吧。 - 有个实用建议：正式录制前，不妨先在一个空白文件里完整演练一遍流程（比如模拟“跳到行尾→输入分号→回车”），确保每个步骤都干净利落，然后再去实际场景中录制。
保存后快捷键没反应：路径、命令、大小写三处全得严丝合缝
刚录好的宏只是暂存在内存里，一旦关闭Sublime就会消失。想让它持久生效，必须立刻将其保存为文件，而且路径格式有严格讲究，比如 Packages/User/add_semicolon.sublime-macro。
file参数必须填写完整的包路径：Packages/User/add_semicolon.sublime-macro✅ 这样写才对，写成add_semicolon.sublime-macro❌ 或者./add_semicolon.sublime-macro❌ 都会导致找不到文件。command字段必须全部小写：只有run_macro_file✅ 能被识别，写成Run_Macro_File或run-macro-file统统无效。- 即使在Windows系统下，路径分隔符也必须使用正斜杠
/，反斜杠\在这里行不通。 - 为宏设置快捷键时，尽量避免单独使用
Shift键的组合，比如["shift+;"]可能不生效，改用["ctrl+alt+;"]这类组合会更可靠。 - 保存完成后，务必通过
Preferences → Browse Packages…菜单打开Packages/User/目录，亲眼确认文件是否真的躺在那里。
回放总出错：不是宏坏了，是起始位置或上下文不匹配
宏的本质是一串按键操作的机械回放，它没有智能，不理解代码语义，也不会做条件判断。所以，同一个宏在不同光标位置或文本环境下运行结果天差地别，这完全是正常现象，并非程序出了bug。
- 举个例子：如果你录制宏时，前提是“光标位于行首”，但回放时光标却在一个单词中间，那么像
Ctrl+Shift+K（删除整行）这样的操作，很可能就会删错行。 - 再比如，你录制了“查找foo并选中下一个”这一系列操作（
Ctrl+F→输入foo→Enter→Ctrl+D），但如果回放时当前文件里根本没有“foo”这个词，那么Ctrl+D这一步就会卡住。 - 多光标操作（例如
Ctrl+D）是可以被录制的，但前提是回放时的文本上下文必须与录制时高度一致。至于Ctrl+Click这类依赖鼠标的动作，则完全不会被记录。 - 想增强宏的适应性？其实可以手动编辑宏文件。打开
Packages/User/xxx.sublime-macro这个JSON文件，手动插入一行像{"command": "select_line"}这样的命令，强制宏在操作前先选中整行，往往能提升健壮性。
最后，一个容易被忽略的关键点是：宏文件本身就是纯文本格式的JSON，完全可读、可编辑、可调试。与其一遍遍重录，不如直接打开文件，删掉多余的操作命令，或者把同一段操作复制粘贴三次来模拟循环效果。它虽然不智能，但足够透明，给了你精细调控的可能。
