Debian如何配置Python开发环境

在 Debian 上配置 Python 开发环境，通常包括 系统更新、安装 Python、包管理工具、虚拟环境、IDE/编辑器 等步骤。下面是推荐且现代的做法（适用于 Debian 11/12）。

一、更新系统

sudo apt update
sudo apt upgrade -y

二、安装 Python（系统自带 + 多版本管理）

1️⃣ 查看系统自带 Python

Debian 12 默认：

python3 --version

⚠️ 不要卸载系统 Python，很多系统工具依赖它。

2️⃣ 安装常用 Python 版本

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

如需其他版本（如 Python 3.11 / 3.12）：

sudo apt install -y python3.11 python3.11-venv python3.11-distutils

三、推荐：使用 pyenv 管理多 Python 版本（强烈推荐）

1️⃣ 安装依赖

sudo apt install -y \
  build-essential libssl-dev zlib1g-dev \
  libbz2-dev libreadline-dev libsqlite3-dev \
  libncurses5-dev libncursesw5-dev \
  xz-utils tk-dev libffi-dev liblzma-dev

2️⃣ 安装 pyenv

curl https://pyenv.run | bash

3️⃣ 配置环境变量

编辑 ~/.bashrc 或 ~/.zshrc：

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

加载：

source ~/.bashrc

4️⃣ 使用 pyenv

pyenv install 3.12.1
pyenv global 3.12.1
python --version

四、配置虚拟环境（非常重要）

方法一：使用 venv（推荐）

python -m venv venv
source venv/bin/activate

退出：

deactivate

方法二：使用 virtualenv

pip install virtualenv
virtualenv venv
source venv/bin/activate

五、配置 pip（国内加速）

临时使用

pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple

永久配置

mkdir -p ~/.pip
nano ~/.pip/pip.conf

内容：

[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple

六、安装常用开发工具

pip install --upgrade pip setuptools wheel
pip install requests flask django fastapi numpy pandas

七、安装开发工具（IDE / 编辑器）

1️⃣ VS Code（推荐）

sudo apt install -y wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo install -o root -g root -m 644 microsoft.gpg /etc/apt/trusted.gpg.d/
sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'
sudo apt update
sudo apt install -y code

VS Code 插件推荐：

Python
Pylance
Black Formatter
Ruff

2️⃣ PyCharm

sudo snap install pycharm-community --classic

八、代码格式化 & Lint（现代 Python 开发）

pip install black ruff mypy

VS Code 中自动格式化：

{
  "python.formatting.provider": "black",
  "editor.formatOnSave": true
}

九、示例：完整开发流程

pyenv install 3.12.1
pyenv local 3.12.1
python -m venv .venv
source .venv/bin/activate
pip install flask
code .

十、常见问题

❓ pip 不是内部命令

python -m pip install xxx

❓ Debian 默认 python 指向 python2？

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3 1

总结（推荐组合）

✅ Debian + pyenv + venv + VS Code + pip 清华源

如果你告诉我：

是 桌面 / 服务器 / WSL
是否用于 Web / AI / 自动化 / 系统脚本

我可以给你一套更定制化的配置方案。