Ubuntu怎么安装Python开发包

在 Ubuntu 上安装 Python 开发包（python-dev / python3-dev），通常是为了编译依赖 Python 的 C/C++ 扩展（如 pip install 某些包时会用到）。

下面是不同 Ubuntu 版本的推荐做法。

一、快速结论（最常用）

如果你用的是 Python 3（推荐）

sudo apt update
sudo apt install python3-dev

如果你还需要对应版本的头文件和运行时库（强烈推荐）

sudo apt install python3-dev python3-pip python3-venv

二、不同场景的详细安装方式

✅ 1. Ubuntu 20.04 / 22.04 / 24.04（主流）

安装 Python 3 开发包

sudo apt update
sudo apt install python3-dev

头文件位置一般在：

/usr/include/python3.x/

确认安装成功

python3 -c "import sysconfig; print(sysconfig.get_path('include'))"

✅ 2. 指定 Python 版本（如 Python 3.10 / 3.12）

Ubuntu 可能同时有多个 Python 版本：

sudo apt install python3.10-dev
sudo apt install python3.12-dev

查看已安装版本：

ls /usr/bin/python3*

✅ 3. 如果你还在用 Python 2（不推荐）

⚠️ Python 2 已停止维护，不建议新项目使用：

sudo apt install python-dev

三、常见“开发包”相关依赖（非常重要）

很多 Python 包（如 cryptography、psycopg2、numpy）需要以下系统库：

sudo apt install build-essential libssl-dev libffi-dev

推荐一次性安装：

sudo apt install python3-dev build-essential libssl-dev libffi-dev

四、常见问题 & 解决方案

❓ 为什么一定要装 python3-dev？

因为：

• pip install 某些包需要 编译 C 扩展
• 编译时需要 Python.h
• 没有 dev 包会报类似错误：

Python.h: No such file or directory

❓ python3-dev 和 python3 的区别？

❓ pip 安装失败怎么办？

常见问题排查：

sudo apt install python3-dev build-essential
python3 -m pip install --upgrade pip

五、推荐的标准开发环境（最佳实践）

sudo apt update
sudo apt install python3-dev python3-venv python3-pip build-essential

然后：

python3 -m venv venv
source venv/bin/activate

如果你愿意，可以告诉我：

• Ubuntu 具体版本（如 22.04）
• Python 版本（3.8 / 3.10 / 3.12）
• 具体报错的包名

我可以帮你精确定位问题。