主窗口始终不显示，Windows 下 CC Switch 启动异常

Quick fix

先检查 Windows 更新、WebView2 参数等环境因素；现有 issue 没有确认适用于所有情况的通用修复。

Symptom

报错原文复制

进入界面停留2-3秒自动退出

Cause

这组 issue 描述了 Windows 下启动后主窗口不显示或短暂出现后闪退。#5186 的 crash report 指向 tao 0.34.6 的事件循环重入，但维护者表示问题可能在客户端或供应商一侧，CC Switch 无法从根本上修复。评论还提到 Windows 更新 KB5081263 可能影响事件循环，以及设置 WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS 禁用冲突模块后曾解决问题；这些情况并未被证实是所有闪退案例的共同原因。

#5414 仅报告进入界面 2–3 秒后自动退出，评论指向另一条 issue，但没有说明其具体原因或可复现的修复步骤。因此不能确认它与主窗口不显示属于同一根因。

Fix

1. 1

   检查是否安装了评论中提到的 Windows 更新 KB5081263；issue 未提供卸载或回退更新的确认步骤。

2. 2

   可尝试设置环境变量 WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS 为 --disable-extensions --disable-plugins --no-sandbox；一位用户报告此方法解决了问题，但其他用户未确认。

3. 3

   如果仍然闪退，记录 CC Switch 版本、Windows 版本及复现步骤，并补充 crash report；维护者建议提供这些信息以继续排查。

Affected Versions

ToolCC Switch 主窗口

Version3.16.4、3.16.5、3.17.0（报告版本；另有评论提及 3.12.3 和 3.18.0）

PlatformsWindows

Source Issues

本页汇总自 2 个真实 issue

• #5186Windows 10 下启动后后台正常运行，但主窗口始终不显示（HWND 存在，疑似 Tao EventLoop 重入）
• #5414闪退

FAQ

设置 WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS 后能解决吗？

一位用户报告设置为 --disable-extensions --disable-plugins --no-sandbox 后问题解决；issue 没有确认该方法对所有闪退都有效。

这个问题是否由 Windows 更新 KB5081263 引起？

有评论称该更新破坏了 tao 0.34.6 的事件循环，但 issue 未证明它是所有主窗口不显示或闪退问题的共同原因。

相关问题

EGL_BAD_PARAMETER：CC Switch Linux 白屏在受影响的 Linux AppImage 环境中，先预加载宿主机的 libwayland-client；若仍白屏，可改用使用系统组件的 .deb 包。8 issues merged无法正常启动，窗口无响应，被系统要求force quit将 CC Switch 更新到经过相关功能重构的 4.0 或最新版本后重试；若仍复现，提交完整版本、步骤、日志和截图。1 issues merged切换供应商会重置claude settings.json - Claude Code切换前先在“通用配置”中从当前供应商提取配置，并在新供应商中勾选“写入通用配置”。11 issues merged