根本原因是调试与打包运行环境不同：调试加载源码依赖sourcemap，而打包后运行dist/extension.js，若main路径错误、vscode未设externals、librarytarget不匹配或资源未复制，activate将不被调用。
为什么打包后插件不工作，但调试时一切正常？
根本原因是：调试走的是 Extension Development Host 模式，它会加载未编译的源码（src/extension.ts）并依赖 sourceMap 映射；而打包后运行的是 dist/extension.js（或 out/extension.js），此时若入口路径、依赖处理或模块导出有偏差，activate 就不会被调用。
-
package.json中的main字段必须指向打包后的 JS 文件（如"main": "./dist/extension.js"），不能还写./src/extension.ts - Webpack 打包时漏掉了
vscode模块：必须在externals中明确声明vscode: "commonjs vscode"，否则运行时报Cannot find module 'vscode' - TS 编译或 Webpack 输出的
libraryTarget不匹配：VSCode 插件要求commonjs2，设成umd或esm会导致activate函数无法被识别 -
devtoolModuleFilenameTemplate配置错误：若设为[absolute-resource-path]，调试器找不到源码位置，断点灰掉，但打包后行为本身不受影响——只是你查不到问题
如何验证打包产物是否可被 VSCode 正确加载？
别等发布后再试。本地安装打包产物比“F5 调试”更接近真实环境，能暴露路径、模块、激活逻辑三类关键问题。
- 先执行打包命令（如
npx webpack --mode production或npm run package），确认dist/下生成了extension.js和对应.map文件 - 手动修改
package.json的main指向./dist/extension.js，并删掉outFiles等仅用于调试的字段 - 终端执行：
code --extensions-dir ./my-extension-dist --extensionDevelopmentPath .—— 这会启动一个干净 VSCode 实例，强制从当前目录加载已打包插件 - 打开命令面板（
Ctrl+Shift+P），搜你的命令名；如果没出现，说明activationEvents未触发或contributes.commands未正确注册
打包后命令能注册但执行报错，常见哪几类？
这类问题往往只在打包后浮现，因为调试模式下 TypeScript 编译和 Webpack 处理逻辑不同，变量作用域、this 绑定、异步时机都可能偏移。
-
vscode.window.activeTextEditor为null：打包后没做防御性检查，直接链式调用editor.document.getText()→ 报Cannot read property 'document' of null - 使用了未
require的 Node.js 内置模块（如fs、path）：Webpack 默认不打包它们，但 VSCode 插件运行在 Node 环境中，需显式配置node: { fs: 'empty' }或改用vscode.workspace.fs - 异步操作未
await或未context.subscriptions.push()：比如注册了vscode.workspace.onDidChangeTextDocument但没存引用，打包后 GC 更激进，监听器被提前释放 - 硬编码路径拼接（如
__dirname + '/config.json'）：Webpack 会重写__dirname，导致路径错乱；应改用path.join(context.extensionPath, 'config.json')
打包后中文文案/图标/菜单显示异常怎么办？
打包工具默认不会处理 package.nls.json 或 icons/ 目录，这些资源若没被显式拷贝进 dist/，就会 404 或 fallback 到英文。
- 确认
package.nls.json和所有.svg图标文件已通过 Webpack 的CopyPlugin或 npm script 的cp命令复制到dist/目录下 - 检查
package.json中contributes.menus或contributes.commands的title字段是否用了%command.name%占位符，且对应 key 在package.nls.json中存在 - 图标路径写法必须是相对
package.json的路径，例如"icon": "./icons/light/icon.svg"，不能写../src/icons/...（打包后结构已变） - 如果用了
vscode-nls库做多语言，确保vscode-nls/dev的构建脚本已运行，生成了nls.metadata.json并随插件一起分发
console.log 在打包后都可能因 process.env.NODE_ENV === 'production' 被 Webpack 自动移除——所以别依赖它查问题，该加的 vscode.window.showErrorMessage 或日志写入文件，得提前安排好。
