vsce打包失败主因是package.json缺失或字段不合法，须含publisher、name等必需字段；publish报错多因pat权限不足或eacces；体积超限需靠.vscodeignore剔除node_modules；插件不生效常因activationevents未配置或main路径错误。
vsce 打包失败：找不到 package.json 或 manifest 格式错误
打包前必须确认当前工作目录下存在合法的 package.json，且其中包含 VS Code 插件必需字段："publisher"、"name"、"version"、"engines"、"main"（或 "browser"）、"contributes"（如需贡献命令/视图等）。常见错误是漏写 "engines.vscode"，比如写成 "engines": { "vscode": "^1.80.0" } 而不是 "engines": { "vscode": "^1.80.0" }（注意键名大小写）；或者 "main" 指向了未编译的 TypeScript 文件（如 "main": "./src/extension.ts"），应指向编译后的 JS（如 "main": "./out/extension.js"）。
vsce publish 报错 EACCES 或 401 Unauthorized
这是权限问题，本质是没正确登录或 token 权限不足。必须用 vsce login 登录，输入的是 Personal Access Token（PAT），不是 GitHub 密码。Token 必须在 https://marketplace.visualstudio.com/manage 创建，勾选 Manage extensions 权限（其他权限非必需）。登录后会缓存在 ~/.vsce；若换机器或重装，需重新 vsce login。如果报 EACCES，说明 vsce 没权限读写该文件，可手动删掉 ~/.vsce 再试，或用 vsce login --pat <your-token></your-token> 直接传入。
打包体积过大导致上传失败或安装卡顿
VS Code Marketplace 对单个插件包限制为 50MB，但实际建议控制在 5MB 内。常见原因是把 node_modules 整体打包进 vsix，或未排除开发依赖。确保 .vscodeignore 存在并合理配置：
node_modules src tsconfig.json *.ts .git .nyc_output coverage
同时检查 package.json 中的 "dependencies" 和 "devDependencies" —— 只有运行时真正需要的库才放 dependencies，比如 vscode-languageclient 是必需的，而 typescript 或 @types/node 应在 devDependencies 中，并被 .vscodeignore 自动剔除。用 vsce package --no-yarn 可跳过 yarn install 步骤，避免意外引入。
插件安装后不生效：激活事件或入口文件路径不对
VS Code 不会自动执行任意代码，必须通过 activationEvents 声明何时激活。最简方式是写 "*"（启动即激活），但推荐按需设置，比如 "onCommand:myExtension.sayHello"。同时确认 "main" 指向的 JS 文件导出了 activate 和 deactivate 函数，且函数签名正确：
export function activate(context: vscode.ExtensionContext) { ... }
export function deactivate() { }
如果用了 Webpack 或 esbuild 打包，务必确保输出格式是 CommonJS（module.exports = { activate, deactivate }），而不是 ESM，默认 vsce package 不处理 ESM 入口。TypeScript 编译目标也应设为 es2020 或更低，module 设为 commonjs。
发布不是终点，而是验证起点。最容易被忽略的是 engines.vscode 版本范围太窄（比如锁死 "^1.85.0"），导致用户升级 VS Code 后插件直接禁用；还有就是本地测试用 Launch Extension 调试没问题，但打包后路径解析出错——因为 __dirname 在 vsix 包里指向的是 extension/ 根目录，而非开发时的 out/ 子目录。
