Ubuntu怎么配置Python项目环境

在 Ubuntu 上配置 Python 项目环境，常见且推荐的做法是：系统 Python 不动 + 用虚拟环境（venv / conda / poetry）+ 用 pip 管理依赖。下面按最常用、最稳妥的流程给你讲一遍。

一、确认 Ubuntu 自带 Python

Ubuntu 默认已安装 Python，但不要直接用它做项目开发。

python3 --version

一般输出类似：

Python 3.10.x

查看路径（不要随便改）：

which python3

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

1️⃣ 安装基础工具（必须）

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

说明：

python3：Python 本体
python3-pip：包管理工具
python3-venv：虚拟环境工具
python3-dev：编译 C 扩展需要

三、为项目创建虚拟环境（✅ 强烈推荐）

1️⃣ 进入项目目录

mkdir ~/myproject
cd ~/myproject

2️⃣ 创建虚拟环境

python3 -m venv venv

目录结构：

myproject/
├── venv/

3️⃣ 激活虚拟环境

source venv/bin/activate

激活后终端会变成：

(venv) user@ubuntu:~/myproject$

✅ 此时 python 和 pip 都是隔离的

四、在虚拟环境中安装依赖

1️⃣ 升级 pip（建议）

pip install --upgrade pip

2️⃣ 安装项目依赖

pip install flask

或一次性安装：

pip install -r requirements.txt

五、导出 / 恢复项目环境

导出依赖

pip freeze > requirements.txt

恢复环境（别人或新机器）

pip install -r requirements.txt

六、退出虚拟环境

deactivate

七、推荐的项目结构

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

八、进阶方案（可选）

✅ 使用 Conda（适合数据科学）

sudo apt install -y curl
curl -O https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh

创建环境：

conda create -n myenv python=3.10
conda activate myenv

✅ 使用 Poetry（现代 Python 项目管理）

pip install poetry
poetry init
poetry install

九、常见问题

❓ pip 安装慢？

配置国内源：

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

❓ Ubuntu 有多个 Python 版本？

查看：

ls /usr/bin/python*

指定版本创建虚拟环境：

python3.10 -m venv venv

❓ 系统 Python 被我搞坏了？

✅ 不要动系统 Python ✅ 永远用虚拟环境

十、总结（最稳妥流程）

sudo apt install python3 python3-venv python3-pip
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

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

✅ 是 Web 项目 / 爬虫 / AI / 自动化
✅ Ubuntu 版本（20.04 / 22.04 / 24.04）
✅ 是否需要 Docker / systemd / 生产部署

我可以给你一套完全贴合你项目的配置方案。