Linux 下使用 update-alternatives 切换软件默认版本

update-alternatives 是管理符号链接的工具，在 Ubuntu 和 Debian 中可用。通过它，我们可以方便地切换同一命令使用的软件版本。比如，系统中同时安装了多个 gcc 版本（比如 gcc、riscv64-linux-gnu-gcc 和 aarch64-linux-gnu-gcc），对于不同项目需要使用不同的版本。

原理

update-alternatives 通过软链接来处理 Linux 中多版本切换问题，软链接存储于 /etc/alternatives 目录。

比如，cc 命令（/usr/bin/cc）其实是一个软链接，它指向 /etc/alternatives/cc ，而这也是一个软链接，指向 /usr/bin/gcc ，而这才是最终的可执行文件 。

注册版本

格式：sudo update-alternatives --install <链接> <名称> <路径> <优先级>`
<链接> 即为命令所在的路径
<名称> 为命令的名称
<路径> 为最终的可执行文件的路径
<优先级> 为正整数，数字越大，优先级越高

举个例子：

# 注册 riscv64-linux-gnu-gcc 版本
$ sudo update-alternatives --install /usr/bin/cc cc /usr/bin/riscv64-linux-gnu-gcc 19

# 注册 aarch64-linux-gnu-gcc 版本
$ sudo update-alternatives --install /usr/bin/cc cc /usr/bin/aarch64-linux-gnu-gcc 18

切换版本

格式：sudo update-alternatives --config <名称>

举个例子：

• 把 cc 命令的默认版本由 gcc 切换到 riscv64-linux-gnu-gcc：

  $ sudo update-alternatives --config cc There are 3 choices for the alternative cc (providing /usr/bin/cc). Selection Path Priority Status ------------------------------------------------------------ * 0 /usr/bin/gcc 20 auto mode 1 /usr/bin/aarch64-linux-gnu-gcc 18 manual mode 2 /usr/bin/gcc 20 manual mode 3 /usr/bin/riscv64-linux-gnu-gcc 19 manual mode Press <enter> to keep the current choice[*], or type selection number: 3 update-alternatives: using /usr/bin/riscv64-linux-gnu-gcc to provide /usr/bin/cc (cc) in manual mode

• 把 python3 命令的默认版本由 python3.10 切换到 python3.11：

  $ sudo update-alternatives --config python3 There are 2 choices for the alternative python3 (providing /usr/bin/python3). Selection Path Priority Status ------------------------------------------------------------ * 0 /usr/bin/python3.10 2 auto mode 1 /usr/bin/python3.10 2 manual mode 2 /usr/bin/python3.11 1 manual mode Press <enter> to keep the current choice[*], or type selection number: 2 update-alternatives: using /usr/bin/python3.11 to provide /usr/bin/python3 (python3) in manual mode

移除指定版本

格式：sudo update-alternatives --remove <名称> <路径>

举个例子：

# 移除 riscv64-linux-gnu-gcc 版本
$ sudo update-alternatives --remove cc /usr/bin/riscv64-linux-gnu-gcc

列出可用版本

格式：sudo update-alternatives --list <名称>

举个例子：

# 列出 cc 替换组中可用版本
$ sudo update-alternatives --list cc
/usr/bin/aarch64-linux-gnu-gcc
/usr/bin/gcc
/usr/bin/riscv64-linux-gnu-gcc

查看替换组信息

格式：sudo update-alternatives --display <名称>

举个例子：

• 查看 cc 替换组信息

  $ sudo update-alternatives --display cc cc - auto mode link best version is /usr/bin/gcc link currently points to /usr/bin/gcc link cc is /usr/bin/cc slave cc.1.gz is /usr/share/man/man1/cc.1.gz /usr/bin/aarch64-linux-gnu-gcc - priority 18 /usr/bin/gcc - priority 20 slave cc.1.gz: /usr/share/man/man1/gcc.1.gz /usr/bin/riscv64-linux-gnu-gcc - priority 19

• 查看 python3 替换组信息

  $ sudo update-alternatives --display python3 python3 - manual mode link best version is /usr/bin/python3.10 link currently points to /usr/bin/python3.11 link python3 is /usr/bin/python3 /usr/bin/python3.10 - priority 2 /usr/bin/python3.11 - priority 1

设置默认版本

格式：sudo update-alternatives --set <名称> <链接>

举个例子：

# 设置默认版本为 gcc
$ sudo update-alternatives --set cc /usr/bin/gcc

# 设置默认版本为 riscv64-linux-gnu-gcc
$ sudo update-alternatives --set cc /usr/bin/riscv64-linux-gnu-gcc