插件安装后不自动激活，需检查activationEvents是否匹配触发条件；常见错误包括命令ID不一致、语言ID不匹配或workspaceContains路径错误，应通过开发者工具查看“Activating extension”日志定位问题。
插件安装后不自动激活？检查 activationEvents 配置是否匹配触发条件
VSCode 不会在安装后立即运行插件，而是等某个预设事件发生才调用 activate() 函数。如果插件没反应，大概率是 package.json 里的 activationEvents 写错了。
常见错误包括：
- 写成
"onCommand:extension.sayHello"却忘了在activate中注册同名命令（vscode.commands.registerCommand('extension.sayHello', ...)） - 用
"onLanguage:python"但当前打开的是.pyi文件——它不属于 VSCode 默认的python语言 ID，得加"onLanguage:pythoni" - 依赖
"workspaceContains:package.json"，但工作区根目录下实际是pnpm-lock.yaml，此时应补上"workspaceContains:pnpm-lock.yaml"
调试建议：打开开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools），在 Console 里搜 "Activating extension"，看是否有超时或拒绝激活的日志。
插件卸载后残留进程还在跑？确认 deactivate() 是否被正确调用
deactivate() 是可选钩子，但一旦写了就必须返回 Promise，否则 VSCode 会卡住关闭流程。它不是“插件退出时自动执行”，而是编辑器主动调用、等待其 resolve 后才继续关机。
容易被忽略的点：
- 没 return Promise → 编辑器可能假死，或报错
"Extension 'xxx' took a long time to deactivate" - 在
deactivate()里直接process.exit()或throw→ 破坏卸载流程，后续插件状态不可预测 - 忘记清理定时器、WebSocket 连接、文件监听器（如
fs.watch）→ 进程持续占用资源，表现为 CPU 异常、日志不断刷屏
实操建议：在 activate() 中把所有 disposable 存进 context.subscriptions，VSCode 会在卸载时自动调用 dispose()；若需异步清理（如 HTTP 请求收尾），显式 return 一个 Promise 并 await 完成。
多个插件监听同一事件（如 onSave），谁先执行？没有保证顺序
VSCode 不承诺 activationEvents 触发后各插件的加载顺序，更不保证 onSave、onDidChangeTextDocument 这类事件的响应顺序。你不能假设自己的插件一定比 ESLint 或 Prettier 先拿到文件变更。
这意味着：
- 不要在
onSave里做“覆盖式格式化”并期望其他插件看到原始内容——它们可能已经改过一轮了 - 避免用
setTimeout延迟执行来“抢时机”，这在不同机器上行为不一致 - 若必须串行处理（比如先转译再 lint），应通过明确的命令链（
commands.executeCommand）而非事件监听耦合
真实场景中，ESLint 插件和你的自定义保存钩子同时监听 onSave，结果可能是 ESLint 报错位置偏移，因为代码已被别的插件重写了两次。
插件热重载失败？别依赖 require.cache 清理
开发阶段按 Ctrl+R 重载窗口时，VSCode 会杀掉旧扩展进程、启动新实例，但 Node.js 的 require.cache 不会被自动清空。如果你在模块顶层做了 const config = require('./config.json')，重载后读的还是旧缓存。
典型症状：
- 改了
package.json的contributes.commands，但命令面板里没更新 - 修改了 TypeScript 类型定义，
vscode.ExtensionContext提示仍显示旧字段 - 重启编辑器才生效，热重载形同虚设
解决方法：把动态加载逻辑移到 activate() 函数内，或用 delete require.cache[require.resolve('./xxx')] 显式清除（仅限开发环境）。生产发布前务必删掉这类 hack，否则影响稳定性。
生命周期管理最易被绕过的环节，是把 deactivate() 当作“可有可无的收尾”，而实际上它是插件与编辑器之间唯一受控的解耦出口。哪怕只开一个 WebSocket，漏掉清理就等于埋了个静默泄漏点。
