Ubuntu 怎样确保 Python 安装正确

在 Ubuntu 系统上搞定 Python 环境，说难不难，说简单也藏着不少坑。很多新手上来就是一句 sudo apt install python3，装完就跑，结果后面写代码时发现缺 pip、缺头文件，甚至在虚拟环境里折腾半天。其实，与其靠“运气”凑合，不如花几分钟系统性地验证一下——这才是长久之计。

先说几个快速检查的点：

• 确认版本号：在终端里跑 python3 --version，如果系统里还留着 Python 2，也可以试试 python --version。只要能返回类似 Python 3.x.x 的响应，就说明解释器已经在了。
• 找到可执行文件：用 which python3 或者 which python 看一眼路径，正常情况下应该指向 /usr/bin/python3 这种有效位置。
• 检查包管理状态：运行 apt list --installed | grep python3 看看核心包是不是都在；pip 也没问题的话，跑个 pip3 --version。
• 万一命令不存在，或者版本号对不上，那就按下面的方法走一趟，别犹豫。

标准安装与验证步骤

最直接的做法，没什么花哨：

• 先更新索引：sudo apt update
• 安装核心：sudo apt install python3
• 把 pip 也带上：sudo apt install python3-pip

装完之后验证一下：

• python3 --version 和 pip3 --version 该有的都有了。
• which python3 和 which pip3 路径也对得上。

顺便提一嘴，开发头文件和 venv 最好一起装上。后续编译本地扩展、创建隔离环境都会省心不少：

sudo apt install python3-dev python3-venv

多版本与默认版本管理

如果你手上同时有 Python 3.8、3.9 甚至 3.10，问题就来了：默认究竟用哪个？

方案一：系统自带的 alternatives（推荐稳妥做法）

• 先注册候选版本：
  sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.8 1
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.9 2
• 然后交互选择：
  sudo update-alternatives --config python3

方案二：用 pyenv 管理（适合开发者）

• 安装：curl https://pyenv.run | bash
• 配置到 shell 里（写在 ~/.bashrc 或 ~/.zshrc）：
  export PATH="$HOME/.pyenv/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"
• 安装与切换：
  pyenv install 3.9.7
pyenv global 3.9.7（项目内用 pyenv local 3.9.7）

方案三：非默认小版本，比如 3.8
可以用 deadsnakes PPA：

• sudo add-apt-repository ppa:deadsnakes/ppa
• sudo apt update
• sudo apt install python3.8

需要警惕的是：千万不要随意替换系统自带的 /usr/bin/python。很多系统工具依赖这个路径，一旦改坏了，桌面和核心命令都可能罢工。

虚拟环境与包管理验证

虚拟环境的价值怎么强调都不为过——每个项目都该有自己的小天地。

• 创建：python3 -m venv .venv
• 激活：source .venv/bin/activate（退出用 deactivate）

激活后验证一下：

• python --version 和 pip --version 应该指向虚拟环境目录内的解释器（比如 .venv/bin/python）。
• 把 pip 升个级：python -m pip install --upgrade pip
• 测试安装个包：python -m pip install requests，然后跑 python -c "import requests; print(requests.__version__)"

一句话：用 venv 隔离项目依赖，系统包怎么改都不怕。

常见问题与修复

• 命令未找到：先 sudo apt update，再装 python3 或 python3-pip；确认一下 which python3 返回有效路径。
• 多版本冲突：优先上 update-alternatives 或 pyenv，千万别直接改 /usr/bin/python 的软链。
• pip 不可用或版本过旧：sudo apt install python3-pip，或者在虚拟环境里用 python -m pip 自己升级。
• 编译扩展失败：装上开发依赖就行：
  sudo apt install python3-dev build-essential libssl-dev libffi-dev zlib1g-dev
• 从源码安装：用 ./configure --enable-optimizations，然后 make -j $(nproc)，最后 sudo make altinstall——记得用 altinstall 而不是 install，否则会覆盖系统自带的 Python。

总之，Python 环境的搭建不是玄学，按照上面的步骤走一遍，从基础安装到多版本管理再到虚拟环境，每一步都清晰可控。把这些问题解决在萌芽阶段，后面写代码才能真正心无旁骛。