安装提示缺少libwebkit2gtk-4.1.so.0 cc-switch

Quick fix

在 Rocky 9 安装 rpm 包会因缺少 webkit 依赖失败，升级系统至 Rocky 10.1 即可解决。

Symptom

报错原文复制

安装提示缺少libwebkit2gtk-4.1.so.0

Cause

在 Rocky 9 系统上通过 rpm 包安装 cc-switch 时，由于系统官方源中不包含 libwebkit2gtk-4.1.so.0 依赖库，导致安装直接失败。此外，部分 Windows 用户在 Releases 页面找不到安装包，通常是因为未展开 Assets 列表，或在使用 winget 时遇到了 scope 问题。

Fix

1. 1

   将操作系统升级至 Rocky 10.1 或更高版本。

2. 2

   升级完成后，重新下载并使用 rpm 包安装 cc-switch。

Affected Versions

Toolcc-switch

Version未知

PlatformsLinuxWindows

Source Issues

本页汇总自 5 个真实 issue

• #354releases页面看不到安装包啊
• #837rocky9系统安装失败
• #1097现在怎么下载release windows 安装包找不到啊
• #1524为什么找不到windows的安装包，只有其他俩系统的
• #5762[撤回/Withdrawn] winget scope 问题（本地已解决，误发）

FAQ

Windows 系统在 Releases 页面找不到安装包怎么办？

请展开对应版本（如 v3.10.3）的 Assets 列表查看。如果通过 winget 安装遇到 scope 问题，建议直接手动下载 MSI 安装包进行升级。

相关问题

无法安装和更新 Codex CC Switch升级到 v3.16.3+ 后从「设置 → 关于」重新安装/更新 Codex；若 v3.16.5 仍失败请带日志反馈。2 issues mergederror code is 2503 或升级后图标变白修改 per-user-main.wxs 移除快捷方式 Icon="ProductIcon" 属性即可解决安装失败与升级后图标丢失问题；旧版用户需取消固定后重新固定。2 issues mergedopenclaw.json is not valid JSON - OpenClaw手动为 ~/.openclaw/openclaw.json 中的 models 键添加双引号，以修复严格 JSON 解析失败的问题。3 issues merged