Ubuntu怎样配置Python环境变量

在 Ubuntu 上配置 Python 环境变量，通常主要涉及 PATH（决定系统去哪里找 Python 解释器）以及可选的 PYTHONPATH（决定 Python 去哪里找模块）。下面按常见场景说明。

一、查看当前 Python 环境

1. 查看已安装的 Python 版本

ls /usr/bin/python*

或：

python3 --version

2. 查看 Python 路径

which python3

二、配置 PATH（最常用）

场景 1：使用系统默认 Python（推荐）

Ubuntu 默认已配置好，一般无需额外设置。

echo $PATH

如果 python3 可用，说明 PATH 已包含 /usr/bin。

场景 2：添加自定义 Python（如 pyenv、手动编译）

临时生效（当前终端）

export PATH="/your/python/path/bin:$PATH"

例如：

export PATH="$HOME/.pyenv/bin:$PATH"

永久生效（推荐）

编辑用户环境变量文件：

nano ~/.bashrc

在文件末尾添加：

export PATH="/your/python/bin:$PATH"

生效：

source ~/.bashrc

如果是 zsh：

nano ~/.zshrc
source ~/.zshrc

三、配置 PYTHONPATH（用于自定义模块搜索路径）

⚠️ 不推荐滥用，容易导致模块冲突

临时设置

export PYTHONPATH=/your/module/path:$PYTHONPATH

永久设置

在 ~/.bashrc 中：

export PYTHONPATH="/your/python/module:$PYTHONPATH"

查看当前：

echo $PYTHONPATH

四、使用 pyenv 管理 Python（最推荐方式）

1. 安装 pyenv

curl https://pyenv.run | bash

2. 配置环境变量

export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init --path)"
eval "$(pyenv init -)"

写入 ~/.bashrc 后：

source ~/.bashrc

3. 安装 Python

pyenv install 3.12.1
pyenv global 3.12.1

五、设置默认的 python 命令（可选）

Ubuntu 默认不用 python，只提供 python3。

设置别名

alias python=python3

写入 ~/.bashrc 永久生效。

或使用 update-alternatives（高级）：

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 1

六、虚拟环境（生产环境最佳实践）

强烈建议使用虚拟环境，而不是直接改系统环境变量。

python3 -m venv venv
source venv/bin/activate

激活后：

自动使用虚拟环境中的 Python
不需要修改 PATH / PYTHONPATH

七、常见错误排查

Python 找不到

python3: command not found

✅ 检查 PATH：

echo $PATH

模块找不到

ModuleNotFoundError

✅ 检查：

python3 -m pip show 模块名

如果你能说明 具体场景（例如：系统版本、是否用 pyenv、是否想设置全局/用户级、是否 Docker），我可以给你更精确的配置方案。