Ubuntu22.04报错：ValueError: the symlink /usr/bin/python3 does not point to ...

一、背景

二、如何解决呢？

三、解决步骤

[1. 确定可用的 Python 版本](#1. 确定可用的 Python 版本)

[2. 重新设置符号链接](#2. 重新设置符号链接)

[3. 选择默认版本](#3. 选择默认版本)

[4. 验证：](#4. 验证：)

[四、update-alternatives 详解](#四、update-alternatives 详解)

[1. 命令语法](#1. 命令语法)

[2. 常用选项](#2. 常用选项)

`--install`添加备选项。

`--config`：选择默认版本。

[3. 工作原理](#3. 工作原理)

[4. 示例用法](#4. 示例用法)

[5. 注意事项](#5. 注意事项)

一、背景

最近有同学在Ubuntu22.04上安装软件或执行程序报出以下错误：

ValueError: the symlink /usr/bin/python3 does not point to the python3 default version. It must be reset to point to python3.10。

这个错误很明显，这是一个Python错误，意思是软链接 /usr/bin/python3 没有指向 Python3 的默认版本。它必须重置为指向 Python3.10。

二、如何解决呢？

让/usr/bin/python3这个符号链接指向默认的 Python 3.10 版本就OK了。

在Debian系的系统（如Ubuntu）中可以使用update-alternatives这个软件版本管理工具。

三、解决步骤

1. 确定可用的 Python 版本

确保你系统中安装了 Python 3.10 版本或其他你想要使用的版本。你可以使用以下命令来查看已安装的 Python 版本：

bash 复制代码

ls /usr/bin/python*

这将列出系统中所有的 Python 可执行文件。

2. 重新设置符号链接

使用 `update-alternatives` 命令重新设置 `/usr/bin/python3` 符号链接。例如，如果你想要将其指向 Python 3.10，可以执行以下命令：

bash 复制代码

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1

这会将 Python 3.10 添加到可选列表中，并将其权重设置为 1。

3. 选择默认版本

使用以下命令选择默认的 Python 版本：

bash 复制代码

sudo update-alternatives --config python3

选择你想要作为默认的 Python 版本的编号。

4. 验证：

执行以下命令：

bash 复制代码

ls -l /usr/bin/python3

四、update-alternatives 详解

`update-alternatives` 是一个用于管理系统中软件版本的工具，允许用户在不同的备选项之间进行选择，以及设置默认的备选项。它通常用于系统中存在多个相似软件的情况，例如多个版本的编译器、解释器、JDK 等。

1. 命令语法

bash 复制代码

sudo update-alternatives [options]

2. 常用选项

`--install`添加备选项。

语法如下：

bash 复制代码

 sudo update-alternatives --install /path/to/link name path/to/binary priority

`/path/to/link`: 要设置的符号链接的路径。
`name`: 符号链接的名称。
`/path/to/binary`: 要链接到的实际可执行文件的路径。
`priority`: 优先级，用于确定默认选择。

例如：

bash 复制代码

sudo update-alternatives --install /usr/bin/java java /usr/lib/jvm/java-8-openjdk-amd64/bin/java 100

`--config`：选择默认版本。

语法如下：

bash 复制代码

  sudo update-alternatives --config name

例如：

bash 复制代码

sudo update-alternatives --config java

`--display`：显示当前配置。

语法如下：

bash 复制代码

sudo update-alternatives --display name

例如：

bash 复制代码

 sudo update-alternatives --display java

`--remove`：从备选项列表中删除一个备选项。

语法如下：

bash 复制代码

  sudo update-alternatives --remove name path/to/binary

例如：

bash 复制代码

sudo update-alternatives --remove java /usr/lib/jvm/java-8-openjdk-amd64/bin/java

3. 工作原理

`update-alternatives` 实际上是通过在系统中创建符号链接的方式来管理备选项。这些符号链接通常位于 `/etc/alternatives` 目录下，而实际的可执行文件则可以位于不同的目录中。通过设置优先级，可以确定默认选择。

4. 示例用法

假设有多个 Python 版本，可以使用 `update-alternatives` 设置默认的 Python 版本：

bash 复制代码

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 2
sudo update-alternatives --config python3

这个例子中，通过 `--install` 选项添加了两个备选项，然后通过 `--config` 选项选择默认的 Python 版本。

5. 注意事项

使用 `sudo` 运行 `update-alternatives` 命令，因为这些操作通常需要管理员权限。
在配置完成后，符号链接会指向用户选择的默认备选项，使得系统中的软件可以引用该符号链接而不必关心具体的软件版本。

总的来说，`update-alternatives` 提供了一种灵活的方式来管理系统中的备选软件版本，让用户可以轻松切换默认版本。