Ubuntu 上搭建 Python 开发环境的实用步骤
一 快速起步 APT 安装与验证
- 更新索引并安装基础组件：
- sudo apt update
- sudo apt install -y python3 python3-pip python3-venv
- 验证安装：
- python3 --version
- pip3 --version
- 说明：大多数 Ubuntu 版本已自带 Python 3，上述命令可补齐缺失组件。完成后即可在系统范围内使用 Python 与 pip。
二 项目级开发 使用虚拟环境隔离依赖
- 创建虚拟环境（在项目根目录执行）：
- 激活与退出：
- 激活：source .venv/bin/activate（激活后命令行提示符会出现环境名）
- 退出：deactivate
- 在虚拟环境中使用 pip 安装依赖，避免污染系统包：
- pip install -U pip
- pip install numpy pandas requests
- 常用工作流：
- 生成依赖清单：pip freeze > requirements.txt
- 复现环境：pip install -r requirements.txt
- 提示：在激活的虚拟环境内，通常可直接使用 python 与 pip 命令（无需再写 python3/pip3）。
三 多版本管理 pyenv 安装与切换
- 安装构建依赖：
- sudo apt update
- sudo apt install -y make 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 python-openssl git
- 安装 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.10.12
- 说明：pyenv 可在同一台机器上并行管理多个 Python 版本，适合多项目与多版本并存的开发场景。
四 从源码编译安装特定版本
- 安装依赖（同上节“多版本管理”的依赖命令）。
- 下载与解压（示例版本为 3.10.14）：
- wget https://www.python.org/ftp/python/3.10.14/Python-3.10.14.tgz
- tar -xf Python-3.10.14.tgz && cd Python-3.10.14
- 配置与编译（–enable-optimizations 会进行优化，耗时更长）：
- ./configure --enable-optimizations
- make -j “$(nproc)”
- 安装（使用 altinstall 避免覆盖系统默认 python3）：
- 验证：
- 提示：源码编译适合需要特定版本或自定义编译选项的场景。
五 常见问题与实用建议
- 权限与系统 Python：避免使用 sudo pip 安装包；优先在虚拟环境内安装。若必须系统级安装，请谨慎评估影响。
- 多版本并存与默认版本：
- 使用 pyenv 管理多版本，避免直接替换 /usr/bin/python3。
- 若确需切换系统默认 python3，可用 alternatives（示例）：
- sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1
- 再执行 sudo update-alternatives --config python3 进行选择（操作前请确认系统兼容性）。
- 虚拟环境最佳实践：为每个项目单独创建 venv，用 requirements.txt 管理依赖，便于协作与部署。
