VS Code扩展调试返回undefined是因扩展未正确加载：需检查package.json的main路径、launch.json的type为extensionHost、preLaunchTask触发编译、运行中扩展列表确认；vsix打包缺依赖应使用webpack而非取消忽略node_modules；401错误源于VSCE_PAT环境变量未配置；断点失效多因sourceMap路径不匹配。
vscode.extensions API 在调试时返回 undefined
这是最常见的环境配置失败信号：你写了 vscode.extensions.getextension 或调用了 vscode.extensions.all，但返回空数组或 undefined。根本原因不是代码写错，而是扩展没被正确加载进调试实例。
实操建议：
- 确认
package.json中的"main"字段指向编译后的入口文件（如./out/extension.js），且该文件真实存在 - 检查
launch.json的configurations是否使用了"type": "extensionHost"，而非node或chrome - 确保
preLaunchTask正确触发了 TypeScript 编译（如tsc -watch或npm run compile），否则out/目录为空 - 调试前手动按
Ctrl+Shift+P→ 输入Developer: Show Running Extensions，确认你的扩展名已出现在列表中（状态为 “Running”）
打包后 vsix 安装失败：缺少 node_modules 或依赖报错
vsce package 默认不会把 node_modules 打进去，但如果你用了非纯前端依赖（比如 fs-extra、glob），又没做 webpack 打包，运行时就会抛 Cannot find module 'xxx'。
实操建议：
- 用
vsce ls查看即将打包的文件列表，确认关键依赖是否在其中；若缺失，说明它们被.vscodeignore过滤了（默认会忽略node_modules） - 不要删
.vscodeignore—— 改用webpack构建：在webpack.config.js中设置target: 'node'和externals: { vscode: 'commonjs vscode' }，把业务逻辑打成单文件 - 如果必须保留
node_modules，在.vscodeignore中显式取消忽略：!node_modules/**
，但注意这会让vsix体积暴涨，且可能引入不兼容的 native 模块
发布时报错 Failed Request: 401 Unauthorized
这个错误和 GitHub Token 无关，是 VS Code Marketplace 的个人访问令牌（PAT）没配对或过期。VSCE 工具只认 VSCE_PAT 环境变量，不读取 .vscode/settings.json 或任何配置文件。
实操建议：
- 去 Marketplace Publisher Management 页面生成新 PAT，勾选
Manage extensions权限（仅此一项足够） - 在终端执行：
export VSCE_PAT="your_token_here"
（macOS/Linux）或$env:VSCE_PAT="your_token_here"
（PowerShell） - 验证是否生效：
echo $VSCE_PAT
（Linux/macOS）或echo $env:VSCE_PAT
（PowerShell）；输出应为 token 字符串，不能为空 - 避免在 CI 环境中硬编码 token —— 使用 secret 注入，并确保 CI job 运行时该变量已注入到 shell 环境中（不是仅注入到 Node process.env）
调试器断点不命中、源码映射失效
TypeScript 断点失效，常见于 sourceMap 路径没对齐。VS Code 调试器靠 out/extension.js.map 文件定位原始 src/ 位置，一旦路径写死或相对路径计算出错，就找不到 sources。
实操建议：
- 确保
tsconfig.json中"sourceMap": true且"outDir": "./out"，同时设置"rootDir": "./src"和"sourceRoot": "../src" - 检查生成的
.map文件里sources字段是否为["../src/extension.ts"]这类可解析路径；若出现node_modules/xxx.ts或绝对路径，说明sourceRoot配置错误 - 在
launch.json的调试配置中添加："sourceMaps": true,<br>"outFiles": ["${workspaceFolder}/out/**/*.js"]，强制指定输出文件范围
调试和发布环节的复杂性不在语法，而在环境链路的每个节点都必须精确对齐：编译路径、调试协议、打包规则、认证上下文、source map 映射 —— 少一个环节对不上，问题就会以“看起来像代码错误”的形式浮现。
