CC-Switch 在 WSL Ubuntu 中安装记录

1. 背景

在 WSL Ubuntu 中安装 CC-Switch-v3.14.1-Linux-x86_64.deb 时，直接执行安装命令可能会遇到依赖缺失问题。

安装命令：

复制代码

sudo apt install ./CC-Switch-v3.14.1-Linux-x86_64.deb

或者：

复制代码

sudo dpkg -i CC-Switch-v3.14.1-Linux-x86_64.deb

报错核心内容：

复制代码

Unsatisfied dependencies:
 cc-switch : Depends: libayatana-appindicator3-1 but it is not installed
             Depends: libwebkit2gtk-4.1-0 but it is not installed

原因是 cc-switch 是带 GUI / WebView 能力的桌面应用，在 WSL 中安装时需要额外的 GTK、WebKit、系统托盘相关依赖。

2. 推荐安装流程

2.1 进入 deb 文件所在目录

例如文件在当前用户主目录：

复制代码

cd ~

确认文件存在：

复制代码

ls CC-Switch-v3.14.1-Linux-x86_64.deb

2.2 更新 apt 软件源

复制代码

sudo apt update

2.3 安装 deb 包

推荐使用 apt install ./xxx.deb，因为 apt 会自动解析依赖：

复制代码

sudo apt install ./CC-Switch-v3.14.1-Linux-x86_64.deb

如果中途提示依赖缺失，继续执行下一步修复。

3. 修复依赖问题

如果安装时报错：

复制代码

You might want to run 'apt --fix-broken install' to correct these.

执行：

复制代码

sudo apt --fix-broken install

或者：

复制代码

sudo apt install -f

这一步会自动安装缺失依赖，并继续配置 cc-switch。

4. 手动安装缺失依赖

如果自动修复失败，可以手动安装：

复制代码

sudo apt install libayatana-appindicator3-1 libwebkit2gtk-4.1-0

然后重新配置：

复制代码

sudo dpkg --configure cc-switch

或者重新安装 deb：

复制代码

sudo apt install ./CC-Switch-v3.14.1-Linux-x86_64.deb

5. 如果找不到 libwebkit2gtk-4.1-0

先查看 Ubuntu 版本：

复制代码

lsb_release -a

检查软件源里是否有该包：

复制代码

apt-cache policy libwebkit2gtk-4.1-0

如果没有候选版本，启用 universe 软件源：

复制代码

sudo apt install software-properties-common
sudo add-apt-repository universe
sudo apt update

然后重新安装依赖：

复制代码

sudo apt install libwebkit2gtk-4.1-0

6. WSL 中文显示问题

在 WSL 中安装完成后，如果 cc-switch 或相关 GUI 显示中文乱码、方块，通常是缺少中文字体。

安装中文字体：

复制代码

sudo apt install -y fonts-noto-cjk fonts-wqy-zenhei fonts-wqy-microhei

安装完成后，中文显示问题通常可以解决。

如果仍然显示异常，可以重启 WSL：

复制代码

wsl --shutdown

然后重新打开 Ubuntu。

7. 可选：安装中文 locale

如果不仅是字体问题，还希望 WSL 环境支持中文 locale，可以执行：

复制代码

sudo apt install -y language-pack-zh-hans locales
sudo locale-gen zh_CN.UTF-8
sudo update-locale LANG=zh_CN.UTF-8

重启 WSL：

复制代码

wsl --shutdown

检查：

复制代码

locale

应该能看到：

复制代码

LANG=zh_CN.UTF-8

如果希望命令行错误信息保持英文，只需要安装中文字体即可，不一定要切换中文 locale。

8. 验证安装

查看命令是否存在：

复制代码

which cc-switch

查看版本：

复制代码

cc-switch --version

如果是 GUI 应用，也可以尝试直接启动：

复制代码

cc-switch

9. 常见问题总结

问题 1：dpkg 安装后提示 dependency problems

原因：dpkg 只负责解包和配置，不会自动解决依赖。

解决：

复制代码

sudo apt --fix-broken install

问题 2：apt 提示 libwebkit2gtk-4.1-0 找不到

原因：软件源不完整，通常是未启用 universe。

解决：

复制代码

sudo apt install software-properties-common
sudo add-apt-repository universe
sudo apt update

问题 3：WSL 中中文显示成方块

原因：缺少中文字体。

解决：

复制代码

sudo apt install -y fonts-noto-cjk fonts-wqy-zenhei fonts-wqy-microhei

问题 4：WSL 中不一定需要 CC-Switch GUI

如果只是为了让 Claude Code 接入第三方兼容 API，例如 DeepSeek，也可以直接使用环境变量方式配置，不一定必须安装 cc-switch。

常见配置方式：

复制代码

export ANTHROPIC_BASE_URL="你的兼容接口地址"
export ANTHROPIC_AUTH_TOKEN="你的 API Key"

如果使用 zsh，可以写入：

复制代码

~/.zshrc

如果使用 bash，可以写入：

复制代码

~/.bashrc

10. 最终推荐命令汇总

适合 WSL Ubuntu 的完整安装流程：

复制代码

sudo apt update
sudo apt install -y software-properties-common
sudo add-apt-repository universe
sudo apt update
sudo apt install ./CC-Switch-v3.14.1-Linux-x86_64.deb
sudo apt --fix-broken install
sudo apt install -y fonts-noto-cjk fonts-wqy-zenhei fonts-wqy-microhei

安装后验证：

复制代码

which cc-switch
cc-switch --version

如果中文显示仍有问题，重启 WSL：

复制代码

wsl --shutdown