已发布的VS Code扩展部分功能失效，如何排查修复？

检查打包文件配置 #

• 确认package.json的files字段是否包含所有必要文件。开发环境会加载全部文件，但打包仅包含该字段指定的内容，遗漏代码、资源或配置文件会直接导致功能缺失。比如依赖src/features目录的话，要确保它被加入：

  "files": [
    "out/**/*.js",
    "src/features/**/*",
    "package.json",
    "README.md"
  ]
  

• 检查.vscodeignore文件，避免误排除关键文件。比如不要把编译后的out目录加入忽略列表，否则打包时会直接跳过。

验证编译产物完整性 #

• 开发环境可能直接运行源码，但发布扩展依赖编译后的产物。执行npm run compile或yarn compile后，确认out（或自定义编译目录）包含所有对应源码的编译文件，且无编译报错。
• 手动安装本地生成的.vsix测试：用code --install-extension your-extension.vsix命令安装，在干净的VS Code窗口（无开发环境加载）中验证功能，排除发布平台的问题。

核对激活事件配置 #

• 确认package.json的activationEvents配置正确。开发环境下扩展可能自动激活，但发布后仅触发指定事件才会加载。比如需要打开特定文件激活的话，要配置对应事件：

  "activationEvents": [
    "onCommand:your-extension.commandName",
    "onLanguage:javascript",
    "workspaceContains:.your-config-file"
  ]
  

• 可临时添加*作为激活事件（仅测试用），若功能恢复则说明是激活事件配置问题，测试后记得改回合理配置避免性能损耗。

排查运行时错误 #

• 打开VS Code的「输出」面板，切换到「扩展宿主」频道，查看扩展加载和运行的错误日志，根据报错定位问题（比如模块缺失、权限异常）。
• 打开「开发者工具」（帮助 -> 切换开发者工具），查看控制台的错误信息，多数功能失效源于未捕获的运行时异常。

检查版本依赖兼容性 #

• 确认package.json的engines.vscode字段指定的VS Code版本范围合理。若扩展使用了高版本API，但用户的VS Code版本低于该范围，功能会无法正常工作。
• 检查依赖的npm包是否在dependencies中（而非devDependencies），devDependencies中的包不会被打包进扩展，发布后会出现依赖缺失。

内容的提问来源于stack exchange，提问作者Berry Cherolds