vscode自定义命令必须通过扩展实现，需在package.json中声明commands并在extension.ts的activate里用vscode.commands.registercommand注册，id须完全一致；命令面板搜不到常见原因包括未启动调试窗口、activationevents未配置、id不匹配或编译失败。
VSCode 中的自定义命令必须通过扩展（extension）实现，无法靠配置文件或快捷键绑定“凭空生成”一个新命令。 直接改 keybindings.json 只能绑定已有命令，而真正新增功能入口（比如“一键生成 API Mock 文件”），必须写扩展并注册 vscode.commands.registerCommand。
怎么注册一个可用的自定义命令
注册命令的核心是两步：在 package.json 里声明、在 extension.ts 里实现。缺一不可，且命令 ID 必须完全一致。
-
package.json的contributes.commands字段中添加条目，command值如"my-ext.generate-mock"，这是唯一标识符 -
extension.ts的activate函数中调用vscode.commands.registerCommand("my-ext.generate-mock", () => { ... }) - 回调函数里写具体逻辑，比如读取当前文件、调用
vscode.workspace.fs.writeFile生成新文件 - 务必把返回的
Disposable对象加入context.subscriptions，否则调试时可能重复注册
为什么命令在命令面板里搜不到
常见原因不是代码写错，而是环境或配置没对齐：
- 没按
F5启动调试窗口——只有在“Extension Development Host”窗口中，你写的命令才被加载 -
package.json中的activationEvents没配触发条件，比如缺少"onCommand:my-ext.generate-mock"，导致扩展根本没激活 - 命令 ID 大小写或连字符不一致：注册时写
"myExt.generate"，但package.json里写成"myext.generate"，就会静默失败 - 项目根目录下没有
node_modules或 TypeScript 编译失败，extension.js没生成，调试窗口实际运行的是旧代码
如何让命令支持参数和上下文传入
VSCode 命令天然支持参数，而且很多 UI 入口（右键菜单、资源管理器选中项）会自动注入上下文对象，不用手动取。
- 注册时回调函数可带参数：
(uri: vscode.Uri) => { console.log(uri.fsPath); } - 右键菜单触发时，如果配置了
"when": "resourceScheme == file"，VSCode 会把当前右键文件的Uri自动作为第一个参数传入 - 命令面板手动执行时，可以用
vscode.commands.executeCommand("my-ext.do-something", "arg1", 42)显式传参 - 注意：参数类型不会校验，传错类型（比如该传
Uri却传了字符串）会导致运行时报Cannot read property 'fsPath' of undefined
最易忽略的一点：命令注册发生在 activate 里，但 activate 只执行一次。如果你在开发中反复修改逻辑却没重启调试窗口，看到的永远是第一次加载的版本——别只刷新窗口，要关掉整个 Extension Development Host 再按 F5。
