如何从私有仓库托管/安装VS Code扩展并配置内部分发

一、搭建私有扩展仓库的两种可行方案 #

VS Code扩展本质是特殊的npm包，两种方案都适用：

• 基于npm私有仓库：用Verdaccio、Nexus这类工具搭建私有npm仓，直接把扩展作为npm包托管，和你熟悉的.npmrc配置逻辑完全兼容。
• 基于Open VSX私有实例：如果需要更贴合VS Code扩展生态的仓库，可搭建Open VSX的私有服务器（VS Code官方扩展市场的开源替代方案）。

二、配置VS Code指向私有仓库的具体步骤 #

方案1：用npm私有仓库的情况 #

1. 发布扩展到私有npm仓

   • 先在本地配置.npmrc，将私有仓地址设为当前包的registry，比如：

     @your-org:registry=https://your-private-npm-registry.com/
     

   • 用vsce publish命令发布扩展，vsce会自动读取.npmrc的配置，把包推到私有仓。

2. 团队成员配置VS Code

   • 方法一：修改VS Code的settings.json，添加私有仓地址：

     "extensions.npmRegistry": "https://your-private-npm-registry.com/"
     

   • 方法二：让成员在本地用户目录下配置.npmrc，VS Code会自动识别这个配置，在搜索扩展时优先从私有仓查找（如果是组织私有包，记得在.npmrc里指定对应scope的registry）。

方案2：用Open VSX私有实例的情况 #

1. 搭建好私有Open VSX服务器后，用ovsx publish命令把扩展发布到私有实例。
2. 团队成员修改VS Code的settings.json，指定私有Open VSX地址：

   "extensions.openvsx.url": "https://your-private-openvsx.com/"
   

三、注意事项 #

• 不管用哪种方案，都要做好私有仓库的权限控制，确保只有团队内部人员能访问和下载扩展。
• 用npm私有仓时，要确认vsce版本在1.77.0以上，这个版本开始支持读取.npmrc的私有仓配置。
• 配置完成后，建议团队成员先在VS Code扩展市场搜索你的私有扩展，验证是否能正常找到并安装。

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