cc-switch 安装失败:依赖冲突、权限不足与杀软误报
Quick fix
根据报错类型分别处理:旧版 Linux 缺依赖换用社区编译版,Windows 权限不足改装至 AppData,杀软误报可自行编译。
Symptom
Section titled “Symptom”cc-switch : 依赖: libwebkit2gtk-4.1-0 但无法安装它cc-switch 的安装失败问题在不同操作系统上由不同的机制导致,属于同一类安装受阻的变体。
在 Linux(如 Ubuntu 20.04)上,cc-switch 基于 Tauri 2 构建,对系统环境要求较高。官方的 .deb 包依赖 libwebkit2gtk-4.1-0,而旧版系统可能无法提供该库;同时 AppImage 版本要求 GLIBC 版本在 2.32~2.35 之间,Ubuntu 20.04 最高仅支持 2.31,强行升级系统级 GLIBC 风险极大。在 Windows 上,若安装至 C:\Program Files 等系统目录,会因缺乏足够权限修改 cc-switch.exe 而提示权限不足;在 Windows Server 等系统上,可能受系统策略限制提示“禁止进行此安装”。此外,个别 Windows 环境下杀毒软件会对 CC-Switch-v3.11.1-Windows.msi 误报 Trojan:Script/Wacatac.H!ml。
Linux 依赖冲突或 GLIBC 版本过低:不要强行升级系统 GLIBC。建议使用社区针对旧版 Ubuntu 编译的版本,或尝试 cc-switch-cli 命令行版本。
社区编译版地址 # https://github.com/suwenqiang/ccswitch-ubuntu20# CLI 版本地址# https://github.com/SaladDay/cc-switch-cliWindows 提示权限不足无法修改 cc-switch.exe:从 v3.4.0 起默认安装目录已改为 AppData\Local,安装时选择该默认目录即可避免权限问题。
推荐安装路径 # AppData\LocalWindows Server 报错“系统管理员设置了系统策略,禁止进行此安装”:受系统策略限制,暂时先使用免安装的便携版(绿色版)。
# 使用便携版替代 MSI 安装包Windows 杀毒软件误报 Trojan:Script/Wacatac.H!ml:属于极个别情况下的误报,可尝试自行从源码编译。
# 自行编译源码
Affected Versions
Section titled “Affected Versions”Source Issues
Section titled “Source Issues”本页汇总自 11 个真实 issue
- #165我打开的界面怎么和你们的有点不一样啊
- #1534Ubuntu 20.04.6 LTS安装失败,依赖libwebkit2gtk冲突
- #3331有aarch openeuler的安装包吗
- #3832macos 3.16.1 通过ccswitch 仓库搜索的skill安装时出现 安装失败 技能目录不存在:/var/folders/3p/mpm2sws51vdfqnf9gvcq_7lm0000gn/T/.tmpNgJXDI/clone-website 请检查仓库地址和分支名称
- #6047CC Switch 本地环境检查无法识别到通过 Microsoft Store 安装的 Codex Desktop
- #943.4.0 安装失败
- #1212Windows11 报毒 Trojan:Script/Wacatac.H!ml
- #35333.16.1无法安装和更新codex
- #1927打开cc-switch有后台进程没有GUI
- #4544Windows Server 2022 下无法安装 报错 "系统管理员设置了系统策略, 禁止进行此安装。"
- #51633.16.5无法安装和更新codex
- Ubuntu 20.04 安装 AppImage 报错 version `GLIBC_2.35' not found 怎么办?
- 原因是 Ubuntu 20.04 的 GLIBC 版本太旧(最高 2.31),而 cc-switch 需要 2.32~2.35。升级系统级 GLIBC 风险很大不推荐,建议使用社区针对 Ubuntu 20.04 编译的版本或 CLI 版本。
- Windows 安装时提示权限不足无法修改 cc-switch.exe 怎么办?
- C:\Program Files 目录要求一定权限,从 v3.4.0 起默认安装目录已改为 AppData\Local,安装到该目录即可解决。
- Windows Server 2022 安装 MSI 报错“系统管理员设置了系统策略,禁止进行此安装”怎么办?
- 这是系统策略限制导致的,目前没有直接解决办法,建议暂时先使用免安装的便携版(绿色版)。
- Windows 安装包被杀毒软件报毒 Trojan:Script/Wacatac.H!ml 怎么办?
- 极个别情况下会出现误报,可以尝试自己从源码编译。
这是一个非官方社区 wiki,与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。