vscode原生不支持宏录制，因其底层不捕获按键流而只响应命令id；multi-command伪宏需严格满足命令id正确、快捷键显式绑定、when条件匹配三条件，且仅无交互命令才稳定可用。
VSCode 原生不支持宏录制，所谓“录制”只是用 multi-command 手动编排命令序列——不是录按键，而是串命令 ID；配错一个 ID 或漏掉 when 条件，快捷键就静默失效。
为什么不能直接录制按键流
VSCode 编辑器底层不捕获键盘扫描码或鼠标轨迹，所有编辑动作都映射到命令 ID（如 editor.action.formatDocument），而非物理按键。任何试图拦截 keydown 事件的扩展，在输入法切换、多光标、终端聚焦等场景下极易丢步或偏移光标位置。官方明确表示无原生宏计划，社区方案本质是“伪宏”——靠调用真实命令拼接逻辑，不是重放操作流。
multi-command 配置必须满足的三个硬条件
装好 multi-command（作者 ryuta46）后，仅写 multiCommand.commands 不够，必须同时满足：
-
settings.json中定义完整命令序列，且每个字符串都是命令面板里搜得到、右键能“复制命令 ID”的真实 ID -
keybindings.json中显式绑定快捷键，格式为{"key":"ctrl+alt+f","command":"multiCommand.myFormatAndComment"} - 每个命令的
when条件需匹配当前上下文（比如editorTextFocus下才能执行editor.action.commentLine）
哪些命令能稳定放进 sequence，哪些会翻车
不是所有命令塞进去都能跑通。关键看它是否“无交互、无副作用、纯编辑器内执行”：
- ✅ 安全可用：
editor.action.formatDocument、editor.action.commentLine、editor.action.insertLineAfter、workbench.action.terminal.toggleTerminal - ❌ 高风险失效：
editor.action.insertSnippet（含 tabstop 时焦点跳转失败）、git.commit（弹出输入框卡死）、editor.action.clipboardCopyAction（剪贴板内容不可控） - ⚠️ 易偏移：
cursorLeft/cursorRight在中文、emoji、全角字符行里常走错格数；建议改用cursorHome+cursorDown这类语义化移动
验证快捷键是否生效的最小闭环步骤
别只盯着配置文件保存了没——实际触发失败，90% 是因为命令 ID 拼错、when 条件不满足，或快捷键被系统/其他插件占用：
- 打开命令面板（
Ctrl+Shift+P），手动搜索并运行你的自定义命令名，例如multiCommand.myFormatAndComment，观察哪一步报错或跳过 - 确认当前焦点在编辑器内（非终端、非调试控制台），否则
editorTextFocus条件不成立 - 检查
keybindings.json是否有重复key定义，后写的会覆盖前写的，但冲突提示可能被忽略 - 跨平台同步时，别硬写
cmd或ctrl——VS Code 会自动映射，但when表达式里若用了isMac等平台判断，必须显式写出
真正难的从来不是怎么写 JSON，而是把“我想做的操作”准确拆解成 VSCode 能理解的命令链。比如“在当前行末尾加个分号再换行”，不能只写 editor.action.insertLineAfter，得拆成 cursorEnd → type（参数带 {text: ";"}）→ editor.action.insertLineAfter，而 type 命令本身不暴露在命令面板里，必须查文档确认它的合法用法。
