activationEvents配置错误是插件不加载的主因，必须与contributes.commands中command字段逐字一致（含大小写、短横线、命名空间），且TypeScript项目main字段须指向./out/extension.js而非源码路径。
activationEvents 配置错一个字符，插件就永远不会被加载——它不是“可选配置”，而是 VS Code 加载你代码前的准入校验。
为什么 F5 调试时命令不出现、Output 里没日志
按下 F5 后弹出新窗口，但 Ctrl+Shift+P 搜不到命令，或者执行后无响应，大概率不是逻辑写错了，而是 activationEvents 和实际触发行为不匹配。
- 常见错误：注册了
my-ext.insertTime命令，但activationEvents写成["onCommand:myext.insertTime"]（少了个短横线）或["onCommand:insertTime"]（缺前缀） - VS Code 2025 年底起对
"*"实施静默降级：即使写了"*"，也可能被延迟到首次命令调用时才激活，尤其在启用“扩展懒加载”策略的工作区中 - 调试时务必打开主窗口的
Output面板 → 切换到Log (Extension Host)，搜索Failed to activate extension或activation event did not match
onCommand / onLanguage / workspaceContains 怎么选
选哪个取决于你的插件真正需要什么时机启动，而不是“哪个最方便”。过早激活会拖慢 VS Code 启动，过晚则用户第一次用就卡顿或报错。
-
onCommand:xxx：适合工具类命令（如格式化、编码转换），只在用户明确调用时加载，最轻量 -
onLanguage:python：适合语言增强类（比如自动补全、诊断），打开.py文件时激活，注意语言 ID 必须和 VS Code 内部一致（javascript不是js，typescriptreact不是tsx） -
workspaceContains:package.json：适合项目级工具（如一键启动 dev server），但注意它只检查根工作区是否存在该文件，子文件夹不触发 - 避免混用多个条件：VS Code 不支持
AND逻辑，["onLanguage:json", "onCommand:xxx"]表示“任一满足即激活”，不是“必须同时满足”
TypeScript 项目里 main 字段和 activationEvents 的耦合陷阱
即便 activationEvents 完全正确，如果 main 指向错误路径，VS Code 根本不会执行你的 activate() 函数——它连入口都找不到。
- TypeScript 编译后输出默认在
./out/extension.js，所以package.json中的main字段必须是"./out/extension.js"，不是"./src/extension.ts" - 如果你用
ts-node或nodemon直接跑源码，VS Code 插件机制不认——它只加载 CommonJS 格式的 JS 入口 - 确认编译产物存在：运行
npm run compile（或npm run build）后再按 F5；某些模板（如yo code）默认不开启 watch 编译，改完.ts文件后必须手动构建 - 检查
out/extension.js是否导出了activate函数：打开该文件，确认有function activate(context) {或exports.activate = function(context) {
onStartupFinished 和 * 的真实差异
onStartupFinished 不是“启动完成之后马上激活”，而是“VS Code 主进程和 Extension Host 进程都就绪、且所有核心服务（如语言服务器、设置同步）初始化完毕后才触发”。它比 "*" 更晚，但比任意用户操作都早。
-
"*"在旧版中≈立即加载，新版中≈首次需要时加载（含首次命令、首次打开文件等），行为不稳定 -
onStartupFinished是目前唯一能保证“插件在用户开始操作前已就绪”的可靠方式，适合需预热缓存、提前监听全局事件（如vscode.workspace.onDidChangeConfiguration）的场景 - 但它不能替代命令级激活：如果你的插件只提供一个命令，又写了
onStartupFinished，那用户还没敲命令，你的插件就已经占内存跑了——得不偿失
最常被忽略的一点：activationEvents 不是“写上就能用”，它和 contributes.commands 中声明的 command 字符串必须逐字一致，包括大小写、短横线、命名空间；差一个字符，VS Code 就当它不存在。
