点击更新后卡住 - cc-switch

Quick fix

强制退出并重新打开软件，或手动更新至 v3.16.3 及以上版本以修复更新死锁问题。

Symptom

报错原文复制

界面卡住任何地方都无法点击

Cause

在旧版本中，cc-switch 的更新下载、安装和重启流程依赖 WebView 执行 JS。当应用包被替换后，旧 WebView 无法继续运行，导致界面卡住。此外，重启时窗口状态插件锁也会引发死锁。此问题已在 v3.16.3 中修复，新增 install_update_and_restart 将流程全部改到后端执行。此外，集群中提及的 Windows 下 winget 管理的 Claude Code 升级失败（#4212）及 Windows 界面花屏（#4328）属于其他独立且尚未修复的问题。

Fix

1. 1

   强制退出当前卡住的 cc-switch 进程，然后重新打开软件，确认是否已自动更新到最新版本。

2. 2

   如果重新打开后未更新，请手动下载并安装 v3.16.3 或更高版本（当前最新为 v3.16.4）。

Affected Versions

Toolcc-switch

Version< 3.16.3 (已在 v3.16.3 修复)

PlatformsmacOS

Source Issues

本页汇总自 3 个真实 issue

• #4212cc-switch对于winget管理的Claude code会升级失败
• #4318mac系统在点击更新时一段时间会卡住，然后强制关闭重新打开发现已经更新到最新版本了
• #4328显示花屏

FAQ

更新能加一个进度条吗，更新完成提示请重启软件？

官方已在 v3.16.3 中将更新流程移至后端执行以解决卡死问题，关于进度条和重启提示的 UI 优化建议已被记录。

cc-switch 对于 winget 管理的 Claude code 会升级失败且看不见，如何解决？

目前 cc-switch 对 winget 安装的 Claude Code 支持存在问题（#4212），暂无官方修复方案，建议暂时手动使用 winget 命令进行升级。

Windows 重新下载最新版本后打开花屏怎么办？

该问题（#4328）目前尚未有官方确认的修复方案，属于待解决的 bug。

相关问题

codex cli 失败：CC Switch将 cc-switch 升级至 v3.16.3 或更高版本即可修复本地环境检测与升级链路的阻塞问题。2 issues merged在Codex界面，官方订阅无法查询用量 - Codex开启本地路由映射以统计特定模型用量，第三方API需适配查询脚本，Claude官方及Free账号暂不支持查询。8 issues mergederror code is 2503 或升级后图标变白修改 per-user-main.wxs 移除快捷方式 Icon="ProductIcon" 属性即可解决安装失败与升级后图标丢失问题；旧版用户需取消固定后重新固定。2 issues merged