VSCode插件发布失败主因是vsce login未生效或package.json中publisher字段与Marketplace账户名大小写不一致；需确保login后提示的publisher与package.json逐字符匹配，且activationEvents、main路径、contributes.commands等配置正确，icon为128×128 PNG，README首行为#显示名，LICENSE文件存在且非空。
vsce publish 失败，90% 是因为没真正登录或 publisher 字段大小写不一致，不是网络或命令问题。
vsce login 必须手动触发，不能跳过
运行 vsce publish 不会自动拉起登录流程，它只会在上传时静默失败。必须先单独执行：
vsce login
这会打开浏览器跳转 Azure DevOps 授权页——不能手动粘贴 token，也不能用 GitHub 或微软账号密码代替。登录成功后终端会显示：
You are now logged in as <publisher>
这个 <publisher> 必须和 package.json 里的 publisher 字段逐字符一致（包括大小写）。Windows 用户若用 PowerShell，可能因执行策略拦截 token 写入，临时运行：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
package.json 的三个致命字段必须对齐
以下三项错一个，插件就“不存在”：不报错、不激活、命令搜不到、断点不命中。
-
main字段必须指向编译后的 JS 文件，比如"main": "./out/extension.js"；TypeScript 项目写"./src/extension.ts"会导致静默失败 -
activationEvents必须显式声明，不能留空或只写["*"]（VS Code 2025 年底起已对*做懒加载降级）；注册了my-ext.doIt命令，就得配["onCommand:my-ext.doIt"] -
engines.vscode要匹配用户环境，例如"^1.85.0"表示最低要求 VS Code 1.85.0；本地调试建议用 Insiders 版本覆盖最新 API
.vsix 打包前必须人工核对三项硬性合规项
vsce package 只打包，不校验市场规则。这些错误不会在本地暴露，但会被 Marketplace 审核直接拒收，且不给重试机会：
-
icon字段指向的图片必须是 128×128 像素 PNG，路径相对于package.json，文件名不能含空格或中文 -
README.md必须存在，且首行必须是# 显示名（不能是空文件、链接或纯描述） - 必须有
LICENSE或LICENSE.md，内容不能为空（哪怕只写 MIT 一行）
发布命令本身很简单，但依赖前置动作是否做完
确认以上全部通过后，发布就是两步：
vsce package<br>vsce publish
如果想自动升级版本号再发布，可用：
-
vsce publish patch→ 升级 0.1.0 → 0.1.1 -
vsce publish minor→ 升级 0.1.0 → 0.2.0 -
vsce publish major→ 升级 0.1.0 → 1.0.0
注意：vsce publish --packagePath xxx.vsix 仅适用于已打包但未发布的场景，首次发布别绕过 vsce package 直接推——它会跳过编译检查和 .vscodeignore 校验。
