Ubuntu 中 Python 的安装与环境配置教程
一 安装前准备
- 更新索引并升级系统:
- sudo apt update && sudo apt upgrade -y
- 确认系统版本与架构(便于选择合适版本与安装包):
- 安装常用构建依赖(后续编译或某些 pip 包会用到):
- sudo apt install -y build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev libncursesw5-dev xz-utils tk-dev libffi-dev liblzma-dev python3-dev python3-pip
- 说明:Ubuntu 通常预装 Python 3,但版本可能较旧;如无特殊需求,优先使用包管理器安装或升级。
二 方法一 使用 APT 安装(推荐)
- 安装 Python 3 与 pip:
- sudo apt install -y python3 python3-pip
- 验证版本:
- python3 --version
- pip3 --version
- 升级 pip(可选):
- python3 -m pip install --upgrade pip
- 适用场景:追求稳定、与系统兼容性好、快速上手。
三 方法二 安装特定版本(Debian 官方 PPA)
- 启用 Universe 仓库并安装工具(如未安装):
- sudo add-apt-repository universe
- sudo apt install -y software-properties-common
- 添加 deadsnakes PPA 并安装指定版本(示例为 3.10):
- sudo add-apt-repository ppa:deadsnakes/ppa
- sudo apt update
- sudo apt install -y python3.10 python3.10-venv python3.10-dev
- 验证:
- 适用场景:需要 特定小版本(如 3.7、3.8、3.10 等)且希望用包管理器维护。
四 方法三 从源码编译安装(可定制与优化)
- 安装构建依赖(见“安装前准备”)。
- 下载并解压源码(示例为 3.12.x):
- wget https://www.python.org/ftp/python/3.12.x/Python-3.12.x.tgz
- tar -xf Python-3.12.x.tgz && cd Python-3.12.x
- 配置与编译(–enable-optimizations 会延长构建时间,可选):
- ./configure --enable-optimizations
- make -j $(nproc)
- 安装(使用 altinstall 避免替换系统默认 python3):
- 验证:
- 提示:如需将可执行文件放入 PATH,可创建软链接(谨慎操作,避免影响系统 Python):
- sudo ln -s /usr/local/bin/python3.12 /usr/bin/python3.12
- 适用场景:需要特定编译选项、性能优化或最新版本。
五 虚拟环境与多版本管理
- 使用内置 venv 创建隔离环境(推荐):
- python3 -m venv venv
- source venv/bin/activate
- 退出:deactivate
- 使用 pyenv 管理多版本(适合开发与测试多版本共存):
- 安装依赖(见“安装前准备”)
- 安装 pyenv:curl https://pyenv.run | bash
- 配置 shell(写入 ~/.bashrc 或 ~/.zshrc):
- export PATH=“$HOME/.pyenv/bin:$PATH”
- eval “$(pyenv init --path)”
- eval “$(pyenv init -)”
- eval “$(pyenv virtualenv-init -)”
- 重新加载:source ~/.bashrc
- 常用命令:
- pyenv install 3.10.12
- pyenv global 3.10.12
- pyenv local 3.9.18
- pyenv versions
- 使用 update-alternatives 切换系统默认 python(谨慎,可能影响系统工具):
- sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 1
- sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.12 2
- sudo update-alternatives --config python
- 适用场景:项目依赖隔离、同一机器多版本并存与快速切换。