跳转到内容

cc-switch 安装失败:依赖冲突、权限不足与杀软误报

Quick fix

根据报错类型分别处理:旧版 Linux 缺依赖换用社区编译版,Windows 权限不足改装至 AppData,杀软误报可自行编译。

报错原文
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。

  1. Linux 依赖冲突或 GLIBC 版本过低:不要强行升级系统 GLIBC。建议使用社区针对旧版 Ubuntu 编译的版本,或尝试 cc-switch-cli 命令行版本。

    社区编译版地址
    # https://github.com/suwenqiang/ccswitch-ubuntu20
    # CLI 版本地址
    # https://github.com/SaladDay/cc-switch-cli
  2. Windows 提示权限不足无法修改 cc-switch.exe:从 v3.4.0 起默认安装目录已改为 AppData\Local,安装时选择该默认目录即可避免权限问题。

    推荐安装路径
    # AppData\Local
  3. Windows Server 报错“系统管理员设置了系统策略,禁止进行此安装”:受系统策略限制,暂时先使用免安装的便携版(绿色版)。

    # 使用便携版替代 MSI 安装包
  4. Windows 杀毒软件误报 Trojan:Script/Wacatac.H!ml:属于极个别情况下的误报,可尝试自行从源码编译。

    # 自行编译源码
Toolcc-switch
Version3.4.0 - 3.16.3
PlatformsWindowsLinux
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。本站不分发任何软件。