插件命令不生效的首要原因是activationevents与contributes.commands未严格匹配：前者决定插件何时加载，后者声明可用命令，二者id（含大小写、点号）必须完全一致，否则vs code静默忽略而不报错。
插件安装后命令不生效？检查 activationEvents 和 contributes 是否匹配
VSCode 插件不是装上就自动运行的。如果你写了一个 extension.compileAndRun 命令，但命令面板里搜不到，大概率是 package.json 里漏了配置。
必须同时满足两个条件：命令在 contributes.commands 中声明，且插件被正确激活（即触发了 activationEvents）。常见错误包括：
-
contributes.commands写了"command": "extension.compile"，但activate函数里注册的是extension.compileAndRun—— 名字不一致，命令根本不会绑定 - 没设置
"activationEvents": ["onCommand:extension.compileAndRun"]，插件压根没加载，activate函数都不会执行 - 用了
"onLanguage:cpp"激活，但当前打开的是.c文件（语言 ID 是plaintext或c），导致插件未激活
调用编译器时路径不对？优先用 vscode.env.appRoot + 相对路径
硬编码 "C:\mingw64\bin\gcc.exe" 看似能跑，但换台机器就崩。VSCode 提供了更可靠的路径处理方式。
推荐做法是把编译器二进制或脚本放在插件目录下（如 ./bin/gcc.exe），然后用 vscode.env.appRoot 拼接：
const compilerPath = path.join(vscode.env.appRoot, 'extensions', 'your-publisher.your-extension-1.0.0', 'bin', 'gcc.exe');
或者更稳妥：让用户通过 settings.json 配置路径，插件读取 vscode.workspace.getConfiguration('yourExtension').get('compilerPath')。这样既避免权限问题，也兼容 WSL、远程开发等场景。
执行 shell 命令卡死？必须用 async/await + timeout 控制子进程
直接调 child_process.execSync 容易阻塞 UI 线程，尤其编译出错没输出时会假死。真实项目里应该用 spawn 并设超时。
关键点：
- 用
vscode.window.withProgress显示正在编译的提示，避免用户误点多次 - 捕获
stderr而非只看stdout，编译错误基本都走 stderr - 设置
timeout: 10000（10 秒），超时后kill子进程，防止卡住 - 不要忽略
exitCode和signal，比如signal === 'SIGTERM'就说明被手动中断了
调试时看不到编译输出？别只依赖 console.log
插件里的 console.log 默认输出到开发者工具控制台，普通用户根本看不到。真正有用的反馈要落到编辑器 UI 层。
实操建议：
- 编译失败时，用
vscode.window.showErrorMessage('Compilation failed: ' + stderr) - 成功后，在状态栏加一个临时提示：
vscode.window.setStatusBarMessage('✅ Compiled in 234ms', 2000) - 把完整日志写入
vscode.workspace.workspaceFolders[0]?.uri.fsPath + '/.compile-log'，方便复现问题 - 如果涉及多文件编译，考虑用
vscode.window.createOutputChannel('Compiler')输出可折叠、可复制的日志流
最常被忽略的是：插件里调用的编译器本身是否支持静默模式（如 gcc -quiet）——否则大量冗余输出会冲掉关键错误信息。
