Python 安装与配置

2026 年的推荐：直接使用 Python 3.12+，配合 uv 或 pyenv 管理版本。

版本选择

Python 版本	状态	建议
3.9	已停止维护	不推荐
3.10	维护中	旧项目可保留
3.11	稳定 LTS	通用项目推荐
3.12	当前稳定	新项目首选
3.13	最新特性	追求新特性可试

安装方式

macOS（推荐 Homebrew + pyenv）

brew install pyenv
pyenv install 3.12.4
pyenv global 3.12.4

Ubuntu / Debian

sudo apt update
sudo apt install -y python3.12 python3.12-venv python3-pip

Windows

从 python.org 下载安装包，安装时勾选 Add Python to PATH。

验证

python3 --version
python3 -m pip --version

pip 配置

# 升级 pip
python3 -m pip install --upgrade pip

# 切换到国内镜像（按需）
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn

常用命令

pip install <pkg>          # 安装
pip install -U <pkg>       # 升级
pip uninstall <pkg>        # 卸载
pip list                   # 已安装列表
pip freeze > requirements.txt

现代工具：uv

uv 是 2024 年起爆发的 Python 包管理工具，比 pip 快 10–100 倍：

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建虚拟环境
uv venv

# 同步依赖
uv pip sync requirements.txt

# 运行脚本（自动管理依赖）
uv run python manage.py runserver

最佳实践

• ✅ 每个项目独立虚拟环境
• ✅ 用 requirements.txt 或 pyproject.toml 锁定版本
• ✅ 持续升级 pip，避免 CVE
• ❌ 不要用 sudo pip install