如何在Ubuntu中集成Python工具

在 Ubuntu 中集成 Python 工具的标准流程

一 基础安装与环境准备

• 更新索引并安装基础工具：
  • 命令：sudo apt update && sudo apt install -y python3 python3-pip python3-venv
  • 验证：python3 --version、pip3 --version
• 安装常用开发依赖（编译/安装部分包时需要）：
  • 命令：sudo apt install -y build-essential libssl-dev libffi-dev python3-dev
• 说明：Ubuntu 系统工具可能依赖自带 Python，避免卸载系统 Python；日常开发建议使用 python3 与 pip3 命令。

二 项目级隔离与依赖管理

• 使用 venv 创建虚拟环境（推荐在项目根目录执行）：
  • 创建：python3 -m venv .venv
  • 激活：source .venv/bin/activate
  • 退出：deactivate
• 使用 requirements.txt 管理依赖：
  • 导出：pip freeze > requirements.txt
  • 安装：pip install -r requirements.txt
• 建议在激活的虚拟环境中进行安装与运行，避免污染全局环境。

三 多版本共存与默认版本切换

• 使用 update-alternatives 切换默认 python3（系统级、安全可控）：
  • 注册版本：
    • sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1
    • sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 2
  • 交互选择：sudo update-alternatives --config python3
• 使用 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.10.12
• 如需特定小版本（如 3.8/3.11），也可用 Deadsnakes PPA 安装后再配合 alternatives/pyenv 使用。

四 与系统工具及 IDE 的集成

• 系统工具链：
  • 安装与更新代码：sudo apt install -y git vim
  • 运行示例：python3 hello.py
• IDE 与编辑器：
  • VS Code：安装“Python”扩展，选择解释器为项目虚拟环境中的 bin/python（如 .venv/bin/python）。
  • PyCharm：新建项目时指定现有解释器或创建新虚拟环境。
  • 初学者可选 IDLE：sudo apt install -y idle3，命令行输入 idle3 启动。

五 生产部署与常见注意事项

• 生产部署建议：
  • Web 框架示例（Flask）：pip install Flask，运行 python3 app.py 本地测试。
  • 使用 Gunicorn 作为 WSGI 服务器：pip install gunicorn，示例：gunicorn -w 4 -b 127.0.0.1:5000 app:app
• 常见问题与建议：
  • 不要卸载系统 Python；使用虚拟环境隔离依赖。
  • 权限最小化：在虚拟环境内使用 pip install --user 或避免不必要的 sudo pip。
  • 国内网络可使用国内镜像源加速 pip（如 -i https://pypi.tuna.tsinghua.edu.cn/simple）。