插件图标灰色且点击无响应说明宿主进程未激活,需先检查是否被禁用;若已启用则排查扩展冲突、日志错误、路径含中文/空格问题;“开始协作”无限转圈表明初始化失败,应检查网络、代理及认证状态;重装前必须清理globalStorage下对应插件缓存目录;还需验证后台服务进程是否正常运行。

插件图标灰色且点击无响应
这说明插件宿主进程压根没激活,不是功能卡顿,而是根本没起来。常见于 Live Share、CodeTogether 等实时协作插件在更新后或与其它扩展冲突时。
先确认它是否被禁用:打开扩展面板(Ctrl+Shift+X),搜索插件名,看右上角是否显示「已禁用」。如果是,点击启用;如果已是启用状态但图标仍灰,继续排查:
- 执行
code --disable-extensions启动 VS Code,再手动启用该插件——若此时能亮起,说明是其它扩展干扰(尤其注意 GitLens、Prettier、ESLint 类高频后台插件) - 检查输出面板(
Ctrl+Shift+U)中是否有对应插件日志通道,比如Live Share或CodeTogether,打开后看首条日志是否含Activation failed或Cannot find module - Windows 用户特别注意:插件安装路径如含中文或空格(例如
C:\Users\张三\.vscode\extensions\ms-vsliveshare.vsliveshare-1.0.5924),可能导致 Node.js 加载失败,建议临时将 VS Code 安装到纯英文路径
点击“开始协作”后无限转圈
这是最典型的“启动了但卡在初始化”的现象,本质是插件无法完成身份认证或服务连接。Live Share 尤其依赖微软账户登录状态和网络连通性,而 CodeTogether 依赖其私有服务端。
不要直接重装插件——先做轻量级验证:
- 打开命令面板(
Ctrl+Shift+P),输入并运行Developer: Toggle Developer Tools,切换到 Console 标签页,刷新后观察是否有红字报错,如net::ERR_CONNECTION_REFUSED或Failed to fetch,指向代理或防火墙问题 - 检查 VS Code 设置中是否误启用了代理:
http.proxy值非空时,即使系统没设代理,也可能导致 Live Share 连不上https://prod.wts-prod.visualstudio.com - 终端里手动测试关键端点(以 Live Share 为例):
curl -I https://prod.wts-prod.visualstudio.com,若返回401是正常(需鉴权),若超时或Connection refused,说明网络层被拦
重装前必须清理的缓存目录
VS Code 协作插件会把认证令牌、服务配置、本地服务进程状态写进用户数据目录,损坏后重装插件毫无作用。不删干净,下次启动还会读旧坏数据。
对应路径如下(请先退出所有 VS Code 进程):
- Windows:
%APPDATA%\Code\User\globalStorage\ms-vsliveshare.*(或com.github.codetogther.*) - macOS:
$HOME/Library/Application Support/Code/User/globalStorage/ms-vsliveshare.* - Linux:
$HOME/.config/Code/User/globalStorage/ms-vsliveshare.*
注意:globalStorage 下的子目录名带哈希值,别只删文件夹名含 vsliveshare 的——要连同整个 ms-vsliveshare.* 文件夹一并移走(可先重命名备份,如加 .bak 后缀)。清理后重启 VS Code,插件会重建全新状态。
调试服务进程是否真的在跑
协作插件依赖后台服务进程通信(如 LiveShareService.exe 或 codetogether-daemon),这些进程常因权限或杀毒软件被静默终止,导致前端看似启动成功实则失联。
验证方式(以 Windows 为例):
- 任务管理器 → 详细信息 → 查找进程名含
LiveShare、WTS、codetogether的项,若无,说明服务未拉起 - 打开 VS Code 终端(
Ctrl+`),执行ps aux | grep -i live(macOS/Linux)或tasklist /fi "imagename eq LiveShare*"(Windows),确认进程存在 - 若进程缺失,尝试手动触发:命令面板中运行
Live Share: Start Collaboration Session,同时紧盯任务管理器——若进程闪现即消失,大概率是杀软拦截或 .NET Runtime 缺失(Live Share v1.0+ 需要 .NET 6.0 Desktop Runtime)
真正麻烦的不是插件本身,而是它背后那一整套服务链:认证服务、信令中继、本地代理进程、IDE 插件桥接模块。任何一个环节断开,都会表现为“无法启动”。清理缓存和验证进程这两步跳过,就等于在修车时不查油路只换灯泡。











