私有云部署VSCode插件核心是解决依赖就绪、网络放行、认证闭环三件事；code-server需用--extensions-dir指定解压后的绝对路径插件目录，离线应提前下载校验vsix并解压，注意版本兼容与内网服务地址及CORS配置。
私有云平台部署 VSCode 插件，核心不是“装插件”，而是解决三件事：插件运行依赖是否就绪、网络策略是否放行、认证与权限链路是否闭环。直接在私有云节点上用 vscode 或 code-server 安装市场插件基本会失败——因为多数插件的安装器默认走 HTTPS 请求 marketplace.visualstudio.com，而私有云通常屏蔽外网或仅允许白名单域名。
code-server 启动时如何加载本地插件？
code-server 不读取本地 VSCode 的 ~/.vscode/extensions，必须显式指定插件路径。启动命令中需加 --extensions-dir 参数，指向一个已解压好的插件目录：
code-server --extensions-dir /opt/code-extensions --auth password --port 8080
注意：/opt/code-extensions 下应是插件的 unpacked 目录结构（如 continue.continue-1.2.3/），不是 .vsix 文件本身。若只有 .vsix，先用 unzip plugin.vsix -d continue.continue-1.2.3 解压。
- 插件目录权限需为
code-server进程用户可读（常见坑：root 解压后，非 root 用户启动 code-server 无法读取） - 多个插件共存时，不要嵌套子目录，所有插件文件夹应平铺在
--extensions-dir指定路径下 -
--extensions-dir必须是绝对路径，相对路径会被忽略
离线环境下怎么获取 .vsix 插件包？
不能依赖 Extensions: Install from VSIX 命令弹窗——它在私有云浏览器里点开后仍会尝试联网校验签名。正确做法是提前在有网机器下载并验证：
- 从
open-vsx.org搜索插件，例如continue.continue，复制其 JSON API 地址：https://open-vsx.org/vscode/gallery/extensionquery，构造查询请求拿到最新版本下载 URL - 或直接访问镜像站（如国内可用的
https://vscode.nfz.moe）替代官方源 - 下载后建议用
sha256sum plugin.vsix记录哈希，部署时比对，防止中间篡改
别用浏览器右键另存为——部分站点返回的是 HTML 而非真实 vsix，导致解压时报错 invalid zip header。
插件启动报错 “Cannot read property 'onDidChangeActiveTextEditor'” 怎么办？
这是典型 API 兼容性断裂：插件编译时依赖的 VSCode 版本号高于当前 code-server 内置的 vscode-web 运行时版本。例如插件声明 "engines": {"vscode": "^1.85.0"}，但你用的是 code-server 4.0.1（对应 VSCode 1.77.x）。
- 查清 code-server 版本对应的 VSCode 内核版本，参考其 GitHub Release 页面的
VS Code version字段 - 插件作者若未发布兼容低版本的 release，只能降级插件（找旧 tag）、或升级 code-server（注意内核升级可能引入新依赖，如更高 Node.js 版本）
- 临时绕过检查：修改插件
package.json中的engines.vscode字段（不推荐，部分插件会因 API 缺失直接 crash）
这类错误不会出现在日志开头，常藏在浏览器开发者工具的 Console 里，且无堆栈——得打开 DevTools 才能看到。
为什么插件能装上却连不上后端服务？
很多 AI 类插件（如通义灵码、Continue）启动后会尝试连接自己的服务端，地址写死在插件代码里，比如 https://api.aliyun.com/... 或 http://localhost:1328。私有云环境里，这个地址往往不可达。
- 优先查插件文档是否支持配置项覆盖，例如通过
settings.json设置"continue.serverUrl" - 若不支持，需 patch 插件前端代码：定位到插件目录下的
extension.js或dist/中的 bundle，搜索fetch(或axios.create，硬编码替换为目标内网地址 - 容器化部署时，可在
docker-compose.yml中用volumes:挂载修改后的插件目录，避免每次重打镜像
最易被忽略的是 CORS 策略：即使后端地址改成内网，浏览器仍会拦截非同源请求。code-server 本身不代理插件请求，必须由反向代理（如 Nginx）统一处理跨域头，或启用 code-server --disable-telemetry --no-auth 并配合 chrome --unsafely-treat-insecure-origin-as-secure="http://192.168.x.x:8080" 启动浏览器（仅测试环境可行）。
