VSCode插件中直接new WebSocket()会报错，因Webview或扩展主机进程受限，WebSocket构造函数默认不可用；仅插件后台（Node.js环境）和Webview内嵌页面可使用，但需注意跨域、HTTPS混合内容及本地服务可访问性。
VSCode插件里直接 new WebSocket() 会报错
因为 VSCode 插件运行在受限的 webview 或扩展主机进程（非 Node.js 环境），WebSocket 构造函数默认不可用。你在 extension.ts 或 webview 的 HTML 中写 new WebSocket('ws://localhost:8080')，大概率遇到 ReferenceError: WebSocket is not defined 或连接被拦截。
真正能用 WebSocket 的地方只有两类：
- 插件后台进程（即
extension.ts）——但需确认它跑在 Node.js 上（默认是）； - Webview 内嵌页面（HTML + JS）——此时浏览器环境支持
WebSocket，但必须注意跨域和本地服务可访问性。
常见误操作：把后端 WebSocket 服务地址硬编码进 webview 的 JS，结果因 CORS、HTTPS 混合内容或防火墙被拒绝；或者在非 Node 上下文（如 UI 线程）调用 require('ws')，直接崩溃。
用 ws 库在插件进程启动服务端监听
如果你需要插件主动对外提供 WebSocket 接口（比如让外部 Python 脚本往 VSCode 发送日志），就得在插件后台用 ws 启一个服务。别用 socket.io —— 它依赖 HTTP 服务器，而插件没内置 http 模块，集成麻烦且易出兼容问题。
实操要点：
- 在
package.json的dependencies里加"ws": "^8.16.0"（选 8.x，避免 9+ 的 ESM 兼容问题）； - 在
extension.ts中 import：import { Server as WebSocketServer } from 'ws';（TypeScript 下需装@types/ws）； - 监听时指定
host: '127.0.0.1'，别用'localhost'—— 某些系统 DNS 解析慢会导致连接超时； - 务必监听
error事件，否则端口被占时插件静默失败，连日志都不打； - 关闭插件时要手动
wss.close()，否则下次启动可能报EADDRINUSE。
Webview 与插件后台通过 postMessage + WebSocket 中继
Webview 不能直连外部 WebSocket 服务（比如你本地跑的 Python 后端），又不能直接 require Node 模块，这时得靠插件后台做中继：webview 发消息 → 插件收到 → 插件用 ws 转发 → 外部系统响应 → 插件再 postMessage 回 webview。
这么做不是绕路，而是必须：
- 绕过浏览器同源策略和混合内容限制（webview 默认是
vscode-webview://协议）； - 复用插件已有的认证逻辑（比如带 token 的请求头，webview JS 拿不到）；
- 统一错误处理——webview 里
onerror只能告诉你“连接失败”，插件层却能看到具体是 ECONNREFUSED 还是证书错误。
示例关键链路：webview.postMessage({ type: 'send_to_backend', data: { cmd: 'update_config' } });
→ 插件监听 webview.onDidReceiveMessage
→ 插件内 backendWs.send(JSON.stringify(...))
→ 插件监听 backendWs.on('message') → panel.webview.postMessage(...)
Live Share 场景下 WebSocket 连接被拦截的典型表现
如果你的插件在 Live Share 协作会话中尝试建立 WebSocket（比如同步自定义状态），大概率失败，错误常是：Failed to construct 'WebSocket': An insecure WebSocket connection may not be initiated from a page loaded over HTTPS 或直接无响应。
根本原因不是代码写错了，而是 Live Share 会强制所有协作流量走微软中继服务器（wss://prod.liveshare.vsengsaas.visualstudio.com），你插件里写的任意 ws:// 或 wss:// 都会被拦截或重定向失败。
应对方式很实际：
- 协作场景下，放弃直连外部 WebSocket，改用 Live Share 提供的
sharedStateAPI 同步简单键值； - 需要复杂数据流？把逻辑下沉到共享的远程开发容器（Remote - SSH/Dev Containers）里，在容器内起服务，再让插件连容器里的
ws://localhost:xxx； - 绝对不要在
liveshare.serviceUrl配置项里填自建地址——它只对私有部署有效，填了反而让整个协作通道失效。
最常被忽略的一点：WebSocket 连接成功不等于通信稳定。插件进程可能被 VSCode 在后台休眠时回收，导致连接断开无声无息。必须在插件侧实现心跳保活 + 断线重连（指数退避），不能只依赖 ws 库的 ping 机制。
