ctrl+q（windows/linux）或cmd+q（macos）是sublime text唯一有效的宏录制入口，必须看到状态栏“recording macro”提示才算启动；录制内容为纯按键流，回放依赖精确起始位置、上下文及正确保存路径（packages/user/下.sublime-macro文件）。
Ctrl+Q才是唯一有效的录制入口
Sublime Text 的宏录制根本不能靠菜单点击启动。Tools → Record Macro 在多数版本中只是视觉反馈，实际不触发录制；必须用快捷键：Ctrl+Q（Windows/Linux）或 Cmd+Q（macOS）。按下后状态栏右下角闪现 “Recording macro” 才算真正开始——没看到这个提示，就等于白按。
macOS 用户注意：Cmd+Q 默认是退出应用，需先在系统设置里禁用该全局快捷键，否则一按就关掉 Sublime；更稳妥的做法是改用 Ctrl+Q 并确保焦点在编辑区。
- 录制期间所有键盘动作都会被记下：包括
Ctrl+Z、Esc、多余Enter，回放时全会执行 - 鼠标拖选、右键、弹出查找框（
Ctrl+F）、命令面板（Ctrl+Shift+P）会静默中断录制，后续操作全丢 - 多光标操作可以录：比如
Ctrl+Shift+L拆行、Ctrl+D逐词选中，这些是键盘命令，会被捕获
起始位置和操作方式决定宏能否复用
宏不理解语义，只机械重放按键流。你录的是“End→;→↓”，回放时就真只在当前光标处执行这三步——它不会自动找行、不会批量处理、也不会判断上下文是否匹配。
- 开始录制前，把光标放在**典型起始位置**：比如某行开头、或任意一个字符左侧，避免依赖不确定的选区状态
- 全程用键盘定位：用
Home/End，不用鼠标点；用Ctrl+L选整行，不用拖选 - 想在每行末尾加分号？推荐录
End→;→↓，而不是先鼠标选中再输入，否则下一行光标可能错位 - 如果操作涉及文件类型敏感功能（如 Emmet 补全），回放时必须确保当前视图是
.html文件且插件启用，否则卡住
保存路径和 JSON 结构必须严格匹配
刚录完不保存，关掉 Sublime 就彻底丢失。保存不是点“确定”就行，关键在路径和命名规则：
- 必须通过
Tools → Save Macro或命令面板搜Save Macro触发保存对话框，不能手动复制粘贴到任意目录 - 文件名必须以
.sublime-macro结尾，且**必须存到Packages/User/目录下**——这是硬编码路径，填./xxx.sublime-macro或绝对路径都无效 - 绑定快捷键时，
"file"参数要写成："Packages/User/add_semicolon.sublime-macro"，大小写敏感，Packages和User都不能缩写或小写 - 宏文件本质是 JSON 数组，例如：
[{"command":"move_to","args":{"to":"eof"}},{"command":"insert","args":{"characters":";"}}]，可手动删冗余命令或插入{"command":"select_line"}提高鲁棒性
回放失效时优先排查这三个点
点了 Playback Macro 却只跳光标、不输字符？问题几乎总出在这三点：
- 光标不在预期位置：宏不自动导航，你录的是“删当前行”，就得把光标放在目标行首再回放
-
上下文不一致：比如录制时在 Python 文件里用了
Tab触发 snippet，回放时在 JSON 文件里，Tab就只是缩进，行为完全不同 -
宏还在内存里没保存：刚录完没执行
Save Macro，重启 Sublime 后宏就没了——它不像 VS Code 那样自动持久化
验证是否录对，最快方法是停止录制后立刻按 Ctrl+Shift+P 搜 Playback Macro 执行一次，看是否复现原动作；不行就重录，别试图修错的 JSON。
