VSCode插件调试扩展包发布前检查-VSCode-PHP中文网

vs code调试时vscode.extensions返回undefined是因为扩展未加载进调试实例，需检查package.json的main路径、launch.json的type为extensionhost、prelaunchtask是否执行、以及developer: show running extensions中扩展状态是否为running。

vscode插件调试扩展包发布前检查

调试时 vscode.extensions 返回 undefined 怎么办

这不是代码写错了，而是扩展根本没加载进调试实例。VS Code 启动的调试窗口（F5 弹出的新窗口）和主窗口是隔离的，你的扩展得在那个新窗口里“活”起来才行。

检查这四点：

package.json 里的 "main" 字段必须指向编译后的 JS 文件，比如 "./out/extension.js"；如果还指着 ./src/extension.ts，那调试时压根不会执行你的逻辑
launch.json 的 "type" 必须是 "extensionHost"，不是 "node" 也不是 "chrome"
确认 preLaunchTask 真的跑起来了，比如 tsc -watch 或 npm run compile，否则 out/ 目录为空，main 指向的就是个 404
F5 启动后，按 Ctrl+Shift+P → 输入 Developer: Show Running Extensions，看你的扩展名是否出现在列表里，状态是 “Running”

vsce package 打包后 .vsix 安装失败常见原因

双击安装只报 “Failed to install extension”，实际问题藏在三个地方：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

engines.vscode 版本不匹配：比如你写了 "^1.85.0"，但用户用的是 1.84.x，就会直接拒绝安装；本地测试建议用 VS Code Insiders 版覆盖最新 API
activationEvents 配得太窄：比如只写了 onCommand:my-ext.doStuff，但用户没手动触发命令，扩展就永远不会激活；临时加 "*" 能验证是不是激活问题（上线前务必删掉）
.vscodeignore 过度过滤：默认会忽略 node_modules 和 src/，但如果你把 Webview 构建产物放在 webview/dist，而该路径没被显式保留，打包时就没了；运行 vsce ls 可以预览实际打进 vsix 的文件列表

vsce publish 报 401 或 Failed to publish 怎么定位

这不是网络问题，是认证链断了。VSCE 工具只认 VSCE_PAT 环境变量，不读任何配置文件或 settings。

必须先运行 vsce login，它会打开浏览器走 Azure DevOps 授权流程；跳过这步直接 publish 必然失败
package.json 中的 publisher 字段必须和 Marketplace 后台注册的发布者 ID **完全一致**（大小写敏感），输错一个字母都会提示 Publisher not found
PAT 权限至少勾选 Marketplace (Manage)；如果插件依赖私有 Git 仓库，还得加 Code (Read)
Windows 用户注意：PowerShell 默认禁止执行脚本，vsce login 生成的凭证文件可能因策略被拦截，临时执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 更稳

TypeScript 项目里 registerCommand 不生效的硬伤

看着就一行代码，但挂掉的原因全是细节错位：

vscode.commands.registerCommand 第一个参数（命令 ID）必须和 package.json 中 contributes.commands.command 的值**逐字一致**，包括大小写、点号、连字符位置
命令 ID 绝对不能以 vscode. 开头——这是保留命名空间，VS Code 会直接拒绝注册
漏掉 context.subscriptions.push(disposable) 是最隐蔽的坑：命令注册后立即被释放，F5 启动后查无此命，Output 面板也看不到错误
用 pnpm 或 yarn 时，npm install 可能没真正装上 @types/vscode，导致 TS 编译通过但运行时报 vscode is not defined；手动补一句 pnpm add -D @types/vscode 更可靠