CC-Switch 在 WSL Ubuntu 中安装记录

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
相关推荐
无忧.芙桃10 小时前
Linux系统编程(四):用户与权限管理
linux·运维·服务器
谙弆悕博士12 小时前
多智能体架构详解:层级树状架构(分级主从型)
运维·架构·大模型·agent·多智能体·langgraph·层级树状
戊本菌13 小时前
进程(三)进程优先级:谁先上 CPU
linux·c语言·硬件架构
aningx14 小时前
Arch 系用 greetd 实现开机自动进 Plasma Wayland,注销自动回桌面
linux
江无行者14 小时前
Linux 服务器 top 命令详解
linux
HMS工业网络15 小时前
工业远程访问的五项安全部署原则
运维·服务器·安全
吴建旭 智宅焕16 小时前
智能家居全国交付中执行端能力评估与分级调度架构设计:从注册数量到交付确定性的系统实现
运维·智能家居·devops
嵌入式 Linux手记16 小时前
一块内存,三种解释:union 的真实用法
linux·c语言·驱动开发·嵌入式
星恒随风17 小时前
MySQL 从零入门(九):事务管理详解——ACID、COMMIT、ROLLBACK、SAVEPOINT 与四种隔离级别
linux·服务器·数据库·笔记·mysql
草莓熊Lotso17 小时前
【C++ 基于微服务的即时通讯系统】ElasticSearch 用户数据管理实现
linux·数据库·c++·elasticsearch·微服务·架构