VS Code 1.82加载Webview报错的原因及解决办法

问题重现场景 #

在VS Code 1.82版本中，以下依赖Webview的功能偶尔会触发错误：

• 内置媒体预览扩展（图片查看）
• adpyke.codesnap扩展
• 内置Markdown预览功能
• Postman.postman-for-vscode、rangav.vscode-thunder-client扩展
• 执行内置Simple Browser: Show命令

错误提示：

Error loading webview: Error: Could not register service worker: InvalidStateError: Failed to register a ServiceWorker: The document is in an invalid state..

且问题仅在VS Code启动缓慢时出现，启动正常则无此报错，排除高权限运行导致的问题（与旧版1.56的同类问题成因不同）。

可能成因 #

• Webview初始化时机异常：启动缓慢意味着VS Code核心/渲染进程初始化滞后，Webview在文档状态未就绪时提前触发Service Worker注册，直接抛出状态错误。
• Webview缓存损坏：长期使用后，Webview的Service Worker缓存或本地存储出现异常，既会拖慢启动速度，也会导致注册流程失败。
• 系统资源不足：启动时CPU、内存占用过高，渲染进程无法及时完成文档状态初始化，Webview注册逻辑因超时或状态异常失败。
• 第三方软件干扰：安全软件拦截Service Worker注册请求、系统代理/网络设置异常，都会干扰Webview初始化，同时拖慢启动。

解决方法 #

1. 清理Webview缓存 #

• 先打开命令面板（Ctrl+Shift+P/Cmd+Shift+P），执行Developer: Reload Window重载窗口，看是否恢复。
• 若无效，手动删除缓存目录：
  • Windows：删除%APPDATA%\Code\Cache和%APPDATA%\Code\CachedData
  • macOS：删除~/Library/Application Support/Code/Cache和~/Library/Application Support/Code/CachedData
  • Linux：删除~/.config/Code/Cache和~/.config/Code/CachedData
• 删除后重启VS Code。

2. 减少启动负载，禁用冗余扩展 #

• 打开扩展面板，禁用不常用的扩展，尤其是启动时自动激活的类型。
• 执行Extensions: Show Running Extensions查看后台运行的扩展，关闭非必要项，降低启动时的资源消耗。

3. 调整启动参数优化渲染 #

• 右键VS Code快捷方式，在目标栏末尾添加启动参数（注意参数前加空格）：
  • --disable-gpu：禁用GPU加速，避免渲染进程异常导致的状态错误
  • --no-sandbox：禁用沙箱，部分环境下沙箱会拦截Service Worker注册
• 保存后重启VS Code生效。

4. 排查系统资源与第三方干扰 #

• 启动VS Code前关闭占用高的后台程序，确保CPU、内存充足。
• 临时关闭安全软件、代理工具，测试是否恢复正常，排查拦截行为。

5. 重置VS Code设置 #

• 打开命令面板，执行Preferences: Reset Settings恢复默认设置，排除自定义配置导致的初始化异常。
• 重置后重新安装必要的扩展即可。

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