CC-Switch 升级指南

基本信息

升级步骤

1. 查看当前版本

dpkg -s cc-switch | grep Version

2. 查看最新版本

访问 https://github.com/farion1231/cc-switch/releases 查看最新 release 版本号。

3. 下载最新 deb 包

根据系统架构选择对应文件：

架构 文件名
x86_64 (amd64) CC-Switch-v{版本号}-Linux-x86_64.deb
arm64 CC-Switch-v{版本号}-Linux-arm64.deb 
# 查看系统架构
uname -m

# 下载 deb 包（替换 {版本号} 为实际版本，如 3.18.0）
cd /tmp
wget -O CC-Switch-v{版本号}-Linux-x86_64.deb \
  "https://github.com/farion1231/cc-switch/releases/download/v{版本号}/CC-Switch-v{版本号}-Linux-x86_64.deb"

4. 安装升级

sudo dpkg -i CC-Switch-v{版本号}-Linux-x86_64.deb

如果提示依赖问题，执行：

sudo apt-get install -f

5. 验证版本

dpkg -s cc-switch | grep Version

确认输出为期望的新版本号即可。

6. 清理下载文件

rm /tmp/CC-Switch-v{版本号}-Linux-x86_64.deb

WSL 中执行注意事项

在 Windows 中通过 WSL 执行升级命令时，需要以 root 用户运行 dpkg：

# 方式一：直接指定 root 用户（推荐）
wsl -d Ubuntu -u root -e dpkg -i /tmp/CC-Switch-v3.18.0-Linux-x86_64.deb

# 方式二：在 WSL 内使用 sudo（如果 sudo 免密配置已生效）
wsl -d Ubuntu -- bash -c "sudo dpkg -i /tmp/CC-Switch-v3.18.0-Linux-x86_64.deb"

一键升级脚本

将以下内容保存为脚本，每次升级只需修改 VERSION 变量：

#!/bin/bash
VERSION="3.18.0"  # 修改为目标版本号
ARCH=$(uname -m)

if [ "$ARCH" = "x86_64" ]; then
  DEB_NAME="CC-Switch-v${VERSION}-Linux-x86_64.deb"
elif [ "$ARCH" = "aarch64" ]; then
  DEB_NAME="CC-Switch-v${VERSION}-Linux-arm64.deb"
else
  echo "不支持的架构: $ARCH"
  exit 1
fi

URL="https://github.com/farion1231/cc-switch/releases/download/v${VERSION}/${DEB_NAME}"

cd /tmp
wget -O "$DEB_NAME" "$URL"
sudo dpkg -i "$DEB_NAME"

# 验证
NEW_VER=$(dpkg -s cc-switch | grep Version | awk '{print $2}')
echo "当前版本: $NEW_VER"

# 清理
rm "$DEB_NAME"

SHA256 校验（可选）

下载后可校验文件完整性，SHA256 值在 release 页面的 Assets 列中可找到：

sha256sum CC-Switch-v{版本号}-Linux-x86_64.deb

对比 release 页面给出的 sha256 值是否一致。

常见问题

问题 解决方案
dpkg 提示权限不足 使用 sudo 或以 root 用户执行
依赖缺失 运行 sudo apt-get install -f
旧版本未卸载 dpkg -i 会自动覆盖旧版本，无需手动卸载
WSL 中 sudo 无法免密 使用 wsl -d Ubuntu -u root -e 方式执行