必须通过activate函数调用vscode.commands.registerCommand注册命令ID和回调函数，并在package.json中严格匹配contributes.commands与activationEvents，否则命令不可见、不执行；需用context.subscriptions.push管理生命周期，且命令逻辑须做空值校验与异步等待。
vscode插件里怎么定义可调用的命令函数
不是写个 function 就能被 VS Code 识别并执行的。必须通过 activate 函数注册到扩展上下文（context）中，否则命令不会出现在命令面板，也触发不了。
常见错误是直接在 extension.ts 里写了个 myHelper()，但没调用 context.subscriptions.push() 或 vscode.commands.registerCommand() —— 这时无论你怎么按 Ctrl+Shift+P 搜名字，都找不到。
-
registerCommand第一个参数是命令 ID（如"myExtension.insertDate"），必须全局唯一，建议带前缀避免冲突 - 第二个参数是回调函数，它接收的参数来自命令调用方（比如从右键菜单传入的
vscode.Uri） - 务必用
context.subscriptions.push()管理生命周期，否则禁用插件时命令可能残留
如何让自定义函数响应编辑器上下文（比如只在 .ts 文件生效）
硬编码判断文件后缀（if (ext === 'ts')）容易漏掉 .tsx、.d.ts，也不支持语言模式切换后的动态行为。VS Code 提供了更健壮的机制。
推荐做法是在 package.json 的 contributes.commands 里加 when 条件表达式：
{
"command": "myExtension.formatApiCall",
"title": "Format API Call",
"when": "editorTextFocus && resourceLangId == typescript"
}
这样命令只在 TypeScript 文件获得焦点时才显示。其他常用条件：
-
resourceExtname == '.json'：限定特定后缀 -
editorHasSelection：仅当有选中文本时启用 -
viewItem == 'explorer' && view == 'explorer'：限定在资源管理器视图中
为什么自定义函数执行后没反应或报错“Cannot read property 'activeTextEditor'”
这是最常踩的坑：你在命令回调里直接访问 vscode.window.activeTextEditor，但用户可能根本没打开编辑器（比如刚启动 VS Code 就运行命令），此时该属性为 undefined。
必须做空值检查，且不能只判 null，要同时检查 undefined 和 document 是否存在：
const editor = vscode.window.activeTextEditor;
if (!editor || !editor.document) {
vscode.window.showErrorMessage('请先打开一个文件');
return;
}
另外注意：异步操作（如 vscode.workspace.openTextDocument()）返回的是 Promise，不能直接链式调用 editor.edit() —— 后者需要同步拿到编辑器实例。得用 await 或 then() 确保文档已加载完成。
调试时断点不命中或 console.log 不输出
VS Code 插件运行在两个进程：Extension Host（你的代码）和 Renderer（UI）。console.log 默认输出到 Extension Host 的 DevTools 控制台，不是你主窗口的开发者工具。
正确调试方式：
- 按
F5启动调试后，在弹出的「Extension Development Host」窗口中操作，命令才会走你设的断点 - 查看日志：打开命令面板 →
Developer: Toggle Developer Tools→ 切到 Console 标签页（这是 Extension Host 的控制台） - 别用
debugger语句放在activate外部顶层作用域——它会在插件加载时立即触发，而那时调试器可能还没 attach 上
真正难排查的，往往是跨进程通信失败或权限配置缺失（比如没在 package.json 的 activationEvents 里声明 onCommand:xxx），导致插件根本没激活就去调命令。
