Ubuntu如何配置Python开发环境

在 Ubuntu 上配置 Python 开发环境，推荐按照**“系统 Python + 虚拟环境 + 常用工具”的方式来配置，既安全又实用。下面给你一套通用、现代、可扩展**的配置方案。

一、检查系统 Python（不要卸载）

Ubuntu 自带 Python，用于系统工具：

python3 --version

✅ 不要卸载系统 Python！

二、安装 Python 开发环境（推荐方式）

1️⃣ 更新系统并安装基础工具

sudo apt update
sudo apt upgrade -y
sudo apt install -y \
  python3 \
  python3-pip \
  python3-venv \
  python3-dev \
  build-essential \
  git \
  curl \
  wget

说明：

python3-venv：虚拟环境支持
python3-dev：编译 C 扩展需要
build-essential：gcc 等编译工具

三、安装新版 Python（可选但推荐）

Ubuntu 默认 Python 可能较旧（如 3.10），如需新版本（如 3.12）：

✅ 方法一：使用 deadsnakes PPA（推荐）

sudo apt install -y software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install -y python3.12 python3.12-venv python3.12-dev

验证：

python3.12 --version

四、配置虚拟环境（强烈推荐）

1️⃣ 创建项目目录

mkdir ~/projects/myproject
cd ~/projects/myproject

2️⃣ 创建虚拟环境

python3 -m venv venv
# 或指定版本
python3.12 -m venv venv

3️⃣ 激活虚拟环境

source venv/bin/activate

激活后提示符会变成：

(venv) user@ubuntu:~/projects/myproject$

4️⃣ 退出虚拟环境

deactivate

五、升级 pip 并配置国内镜像（国内用户必看）

pip install --upgrade pip

配置清华大学镜像（永久）

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

六、安装常用开发工具

1️⃣ 常用 Python 库

pip install numpy pandas requests flask django fastapi

2️⃣ 代码格式化 & 检查（推荐）

pip install black flake8 isort

七、安装 VS Code（强烈推荐）

sudo snap install code --classic

VS Code 插件推荐：

Python
Pylance
Black Formatter
GitLens

八、使用 pyenv（高级用户推荐）

如果你需要多 Python 版本管理：

curl https://pyenv.run | bash

然后按提示添加到 ~/.bashrc 或 ~/.zshrc：

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

安装 Python：

pyenv install 3.12.1
pyenv global 3.12.1

九、推荐项目结构示例

myproject/
├── venv/
├── requirements.txt
├── src/
│   └── main.py
└── README.md

生成依赖文件：

pip freeze > requirements.txt

安装依赖：

pip install -r requirements.txt

十、常见坑位提醒 ✅

问题	解决
pip 不存在	`sudo apt install python3-pip`
权限错误	不要用 `sudo pip`，用虚拟环境
apt 与 pip 冲突	apt 装系统工具，pip 装项目库
多个 Python 混乱	用 `pyenv` 或虚拟环境

总结（最推荐方案）

✅ Ubuntu + python3-venv + 虚拟环境 + VS Code

如果你愿意，我可以：

✅ 给你 AI / Web / 数据分析 / 自动化 针对性配置
✅ 帮你写 自动化安装脚本
✅ 指导 Docker + Python 开发环境

你打算用 Python 做什么？