vsce publish失败主因是权限与配置不匹配：未用Azure PAT登录、publisher字段与Marketplace注册名不一致、PAT权限不足（需勾选Marketplace Manage）；绕过方式为先vsce login配置有效token，再确保package.json中publisher、engines.vscode等字段合法。
vsce publish 命令执行失败：常见原因和绕过方式
直接运行 vsce publish 报错，绝大多数情况不是命令本身问题，而是身份或权限没到位。VS Code Marketplace 要求你用 Azure DevOps 的个人访问令牌（PAT）登录，而不是 GitHub 或微软账号密码。
- 必须提前在 marketplace.visualstudio.com/manage 创建发布者（
publisher），且package.json中的publisher字段必须完全一致（大小写敏感） - 生成 PAT 时，范围（Scopes）至少勾选
Marketplace (Manage)；如果插件含私有 Git 依赖，还需Code (Read) - 首次运行
vsce publish会提示输入 token —— 粘贴后它会被缓存到本地配置（~/.vscode/extensions/下的凭证文件），后续不用重复输 - 若提示
Unauthorized或Publisher not found，优先检查package.json里的publisher和 marketplace 后台注册名是否一字不差
打包前必须完成的三件事：编译、校验、忽略
vsce package 不是“一键压缩”，它会扫描整个项目目录并按规则打包。漏掉关键步骤会导致 .vsix 安装失败或功能缺失。
- 确保 TypeScript 已编译：运行
npm run compile或npm run vscode:prepublish，输出目录（如out/）必须存在且含有效 JS 文件；main字段指向的路径必须可访问 - 检查
.vscodeignore：默认会排除node_modules和src/，但如果你把 Webview 构建产物放在webview/dist，而该路径没被显式保留，就会打包失败 - 运行
npm run lint（如有）：虽然不影响打包，但 ESLint/TSLint 报错可能暴露未处理的undefined或未声明变量，在用户环境里更容易崩溃
vsce package 生成的 .vsix 文件无法安装？先看错误类型
双击 .vsix 或通过 Extensions: Install from VSIX 安装失败，VS Code 通常只报一句 “Failed to install extension”，实际原因分散在不同环节。
- 如果提示
Extension 'xxx' is not compatible with Code 'x.x.x'：检查package.json中engines.vscode字段，比如写成"^1.85.0"就要求用户 VS Code ≥ 1.85.0；本地测试建议用 Insiders 版本覆盖最新 API - 如果安装后命令不出现、Webview 打不开：大概率是
activationEvents配置太窄，比如只写了onCommand:xxx，但没触发命令入口；临时加一条*可验证是否激活问题（上线前务必删掉） - 如果安装成功但控制台报
Cannot find module './xxx'：确认main或browser字段路径正确，且对应文件在out/或打包后根目录下真实存在（注意大小写和扩展名）
私有分发 vs 官方市场：发布路径选择的关键差异
决定走官方市场还是私有部署，核心不在技术难度，而在维护预期和用户场景。
- 上官方市场意味着：每次
vsce publish都会全量更新，旧版本不可回退（除非手动下架再重发）；用户升级完全不可控，必须靠engines.vscode和activationEvents拦住不兼容环境 - 走私有分发（如内部 Nexus 或 Open VSX）：可保留多个
.vsix版本供回滚，适合企业内网场景；但需自行维护更新逻辑，VS Code 默认不会自动检查私有源 - 最容易被忽略的是
icon和galleryBanner字段：官方市场强制要求 128×128 PNG 图标（icon），否则审核不通过；而私有分发完全不校验这些
