Ubuntu Python开发环境怎样搭建

Ubuntu Python 开发环境搭建指南

一 基础安装与版本管理

• 更新系统并安装基础工具：
  • 命令：sudo apt update && sudo apt upgrade -y
  • 安装：sudo apt install -y python3 python3-pip python3-venv
  • 验证：python3 --version、pip3 --version
• 多版本需求的两类做法：
  • 使用 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
  • 使用 pyenv 管理多版本（适合在 3.x 各版本间切换）：
    • 安装依赖：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 于项目目录设定本地版本）

二 虚拟环境与依赖管理

• 创建与激活（在项目根目录执行）：
  • 创建：python3 -m venv venv（或 python3.10 -m venv venv 指定版本）
  • 激活：source venv/bin/activate
  • 退出：deactivate
• 使用 pip 与 requirements.txt：
  • 升级 pip（在虚拟环境内）：python -m pip install --upgrade pip
  • 安装依赖：pip install -r requirements.txt
  • 导出依赖：pip freeze > requirements.txt
• 加速下载（可选，配置用户级镜像）：
  • 创建目录：mkdir -p ~/.config/pip
  • 写入配置：nano ~/.config/pip/pip.conf
  • 内容：
    • [global]
    • index-url = https://mirrors.aliyun.com/pypi/simple/
    • [install]
    • trusted-host = mirrors.aliyun.com

三 开发工具与 IDE

• VS Code：
  • 安装（稳定通道）：sudo snap install code --classic
  • 插件：安装官方 Python 扩展（作者：Microsoft）
  • 选择解释器：Ctrl+Shift+P → 输入并选择 Python: Select Interpreter → 指向虚拟环境中的 venv/bin/python
• PyCharm：
  • 安装：sudo snap install pycharm-community --classic（社区版）或通过 JetBrains Toolbox 安装专业版

四 常见问题与实用建议

• 不要覆盖系统 Python：编译安装时使用 make altinstall；优先通过 pyenv 或 deadsnakes PPA 管理版本，避免直接替换 /usr/bin/python3
• 多版本并存与项目级隔离：用 pyenv local 为项目固定版本，用 venv 隔离依赖；团队协作时把 python-version 与 requirements.txt 纳入版本控制
• 构建依赖：安装编译类包（如 python3-dev、build-essential、libssl-dev 等）以避免安装带 C 扩展的库时报错
• 快速验证脚本（置于项目根目录）：
  • python - <<'PY' import sys, pip, platform print("Python:", sys.version) print("pip:", pip.__version__) print("Platform:", platform.platform()) PY
• 退出与清理：
  • 退出虚拟环境：deactivate
  • 删除虚拟环境：rm -rf venv
  • 卸载通过 PPA 安装的特定版本：sudo apt remove --purge python3.10 python3.10-venv python3.10-dev && sudo apt autoremove -y