VSCode原生不支持宏录制，所谓“一键录制”功能根本不存在；最可靠方案是用multi-command扩展手动编排内置命令ID序列，如editor.action.formatDocument，并在settings.json和keybindings.json中正确配置。
VSCode 原生不支持宏录制，所谓“按一次 Ctrl+Shift+R 开始录、再按一次停止”根本不存在——这不是你操作不对，是它真没这功能。
为什么直接搜 record macro 会失败
你在命令面板（Ctrl+Shift+P）里搜 record macro、startMacro 或 editor.action.startMacro，结果只会看到 command 'editor.action.startMacro' not found。这是官方明确不提供的能力，不是插件没装对，也不是设置漏了哪项。
所有声称“一键录制”的插件，底层要么靠监听键盘事件（易被输入法/多光标打断），要么依赖已弃用的 API（VSCode 1.80+ 后大面积失效）。真正稳定可用的路径只有一条：用真实命令 ID 手动编排序列。
multi-command 怎么配 sequence 才不翻车
装好 multi-command（作者 ryuta46）后，必须在 settings.json 里定义 multiCommand.commands，而不是随便写个函数名就完事。每个 sequence 里的字符串，都得是命令面板里能搜到、右键能“复制命令 ID”的真实 ID。
-
editor.action.formatDocument✅ 可靠，无交互，跨语言通用 -
editor.action.commentLine✅ 行注释，光标位置不影响执行 -
cursorHome+cursorDown✅ 比cursorRight更稳，避开中文/emoji 宽字符偏移问题 -
workbench.action.terminal.toggleTerminal✅ 切换终端，不依赖编辑器焦点 -
editor.action.insertSnippet❌ 含 tabstop 时会卡住，跳转失败不报错 -
editor.action.clipboardCopyAction❌ 剪贴板内容不可控，下次回放可能粘错东西
示例配置片段（注意缩进和逗号）：
{
"multiCommand.commands": [
{
"command": "myWrapInTryCatch",
"sequence": [
"editor.action.insertLineAfter",
"default:type",
{ "args": { "text": "try {" } },
"editor.action.insertLineAfter",
"default:type",
{ "args": { "text": "} catch (err) {" } },
"editor.action.insertLineAfter",
"default:type",
{ "args": { "text": " console.error(err);" } },
"editor.action.insertLineAfter",
"default:type",
{ "args": { "text": "}" } }
]
}
]
}
快捷键绑定后没反应？三步快速定位
配完 multiCommand.commands 不等于能用，必须手动加快捷键映射。常见断点都在这三步：
- 打开
keybindings.json（Ctrl+Shift+P →Preferences: Open Keyboard Shortcuts (JSON)） - 加一条完整记录：
{"key":"ctrl+alt+t","command":"multiCommand.myWrapInTryCatch"}，注意 command 名要和settings.json里"command"字段值完全一致 - 保存后，别急着试快捷键——先在命令面板搜
multiCommand.myWrapInTryCatch手动运行一次，看是否报错；如果报command not found，说明名字拼错或扩展没生效
Windows 下若用 ctrl+alt 组合键没反应，可能是被输入法或杀毒软件劫持，换 ctrl+shift 试试。
哪些场景不该硬上宏，该换思路
宏不是万能胶。遇到这几类操作，强行塞进 multi-command 会越调越崩：
- 需要鼠标点击（比如点某个侧边栏按钮）→ 改用 VSCode 内置的
workbench.view.*类命令，或放弃自动化 - 要跨文件粘贴且目标文件未打开 →
workbench.action.files.newUntitledFile可建新标签，但无法指定路径；得用 task + shell 脚本 - 涉及 Git 提交、调试启动等需用户输入的流程 → 这些命令本身就会弹窗阻塞，宏序列会静默跳过，不如用
tasks.json配 workflow
最常被忽略的一点：宏的可靠性极度依赖当前编辑器状态。比如你写了个“选中 JSON 后格式化 + 复制”的宏，但如果光标不在 JSON 文本里，editor.action.formatDocument 会默默失败——它不会提醒你，也不会报错，只是什么都没干。
