能跑起来的最小扩展需5分钟完成，但发布前必须处理activationEvents配置和vsce登录；yo code生成后F5无反应，主因是activationEvents未匹配触发条件或main字段指向错误路径。
能跑起来的最小扩展，5分钟内就能完成；但发布前必须处理 activationEvents 和 vsce 登录这两个硬门槛。
yo code 生成项目后，为什么按 F5 没反应？
常见错误现象是按下 F5 后弹出新窗口，但 Ctrl+Shift+P 里搜不到命令，或者命令执行后无任何提示——这通常不是代码写错了，而是 activationEvents 配置不匹配。
-
activationEvents默认值为"*"（一启动就加载），但 VSCode 2025 年底起对非必要扩展启用懒加载策略，"*"已被部分版本静默降级 - 正确做法：在
package.json的activationEvents字段中明确声明触发条件，例如你注册了my-ext.insertTime命令，就写["onCommand:my-ext.insertTime"] - 如果改完仍无效，打开主窗口的
Output面板 → 切换到Log (Extension Host)，看是否有Failed to activate extension类错误 - TypeScript 项目务必确认
main字段指向./out/extension.js，而不是./src/extension.ts；否则调试时根本不会执行你的逻辑
vscode.commands.registerCommand 注册失败的三个典型原因
命令注册看似只有一行代码，但实际运行依赖 package.json、路径、大小写三者严丝合缝。
-
registerCommand第一个参数（命令 ID）必须和package.json中contributes.commands.command的值**完全一致**，包括大小写、连字符、点号位置 - 命令 ID 不要以
vscode.开头，这是保留命名空间，VSCode 会直接拒绝注册 - 确保
context.subscriptions.push(disposable)被执行；漏掉这句会导致命令注册后立即被释放，F5 启动后查无此命 - 如果你用的是 pnpm 或 yarn，
npm install可能没真正装上@types/vscode，导致 TypeScript 编译通过但运行时报vscode is not defined—— 手动加一句pnpm add -D @types/vscode更稳
vsce publish 失败：登录和权限问题最常卡在哪
vsce publish 报错往往不报具体原因，只显示 Failed to publish，背后基本是认证链断裂。
- 必须先运行
vsce login，它会打开浏览器让你授权访问 Visual Studio Marketplace；不要跳过这步直接publish - 登录后生成的 token 存在
~/.vscode/extensions/下某个隐藏文件里，Windows 用户要注意 PowerShell 默认禁止执行脚本，可能需要临时执行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -
package.json中的publisher字段必须和 Marketplace 账户名**完全一致**，大小写敏感；填错会导致401 Unauthorized却不提示 - 首次发布前，确保
version是语义化格式（如"1.0.0"），不能是"1"或"v1"，否则vsce会静默退出
真正麻烦的从来不是写功能，而是 activationEvents 写太宽导致启动变慢，或是 vsce 把 token 存错地方后反复重试却得不到明确报错。发布前多看一眼 Log (Extension Host) 和 vsce login --help 输出，比盲调两小时强得多。
