如何让VSCode识别本地未打包的自定义扩展？

关键排查与修复步骤 #

• 校验扩展根目录的package.json
  VSCode识别扩展的核心是根目录下的package.json，必须确保文件存在且包含必填字段：

  • name：设置唯一的扩展ID，不能与原扩展或已安装的其他扩展重复
  • displayName：扩展在侧边栏显示的名称
  • version：遵循语义化版本格式（如1.0.1）
  • engines.vscode：指定兼容的VSCode版本范围（如^1.70.0）
    建议同时修改*publisher*字段，避免与原扩展的发布者标识冲突。

• 清理VSCode扩展缓存
  VSCode会缓存扩展信息，复制后需彻底清理缓存才能重新识别：

  1. 完全关闭所有VSCode窗口
  2. 删除缓存目录：
     • 本地环境：删除~/.vscode/extensions/.obsolete和~/.vscode/extensions/.debug（若存在）
     • 远程环境：删除~/.vscode-server/extensions/.obsolete和~/.vscode-server/extensions/.debug（若存在）
  3. 重新启动VSCode

• 检查目录权限
  确保自定义扩展目录及文件的权限允许VSCode读取：
  在Linux/macOS终端执行：

  chmod -R 755 ~/.vscode/extensions/my-custom-extension
  

  远程环境替换为对应路径~/.vscode-server/extensions/my-custom-extension

• 手动触发扩展安装
  用VSCode内置功能强制加载未打包扩展：

  1. 打开命令面板（快捷键Ctrl+Shift+P/Cmd+Shift+P）
  2. 搜索并执行Extensions: Install from VSIX...
  3. 在文件选择框中选中你的my-custom-extension文件夹（直接选整个文件夹即可）

额外注意事项 #

• 不要仅修改原扩展的文件夹名，必须修改package.json中的唯一标识字段，否则VSCode可能因ID冲突忽略自定义扩展。
• 若自定义扩展依赖其他扩展或原生模块，需确保依赖已正确配置并安装，否则可能加载失败且无明显提示。

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