使用 uv 管理多版本 Python

安装新 Python 版本同时保留现有 3.9 版本，可通过 uv 工具实现隔离管理。uv 采用用户级安装，避免与系统 Python 冲突。

# 查看可安装版本
uv python list

# 安装最新稳定版
uv python install 3.13

# 安装特定小版本
uv python install 3.13.2

创建隔离项目环境

推荐为每个项目创建独立虚拟环境，确保依赖和解释器完全隔离。

# 新建项目目录
mkdir project-name && cd project-name

# 初始化项目环境
uv init --python 3.13

# 或对现有项目添加环境
uv venv --python 3.13 .venv

激活与运行环境

uv 提供自动化环境管理，无需手动激活即可运行脚本。

# 安装项目依赖
uv add package-name

# 自动在隔离环境中运行脚本
uv run python script.py

# 验证当前环境
uv run python --version

验证版本隔离

通过以下命令确认系统 Python 不受影响：

# 检查项目环境版本
uv run python --version

# 检查系统默认版本
/usr/bin/python3 --version

临时使用特定版本

对于单次运行需求，可直接指定版本执行：

uv run --python 3.13 python temp-script.py

目录结构说明

uv 创建的典型隔离环境包含：

• .venv/：虚拟环境目录
• pyproject.toml：项目配置文件
• .python-version：版本锁定文件

所有 Python 解释器默认安装在用户目录：
~/.local/share/uv/python/### 使用 uv 管理多版本 Python

安装新 Python 版本同时保留现有 3.9 版本，可通过 uv 工具实现隔离管理。uv 采用用户级安装，避免与系统 Python 冲突。

# 查看可安装版本
uv python list

# 安装最新稳定版
uv python install 3.13

# 安装特定小版本
uv python install 3.13.2

创建隔离项目环境

推荐为每个项目创建独立虚拟环境，确保依赖和解释器完全隔离。

# 新建项目目录
mkdir project-name && cd project-name

# 初始化项目环境
uv init --python 3.13

# 或对现有项目添加环境
uv venv --python 3.13 .venv

激活与运行环境

uv 提供自动化环境管理，无需手动激活即可运行脚本。

# 安装项目依赖
uv add package-name

# 自动在隔离环境中运行脚本
uv run python script.py

# 验证当前环境
uv run python --version

验证版本隔离

通过以下命令确认系统 Python 不受影响：

# 检查项目环境版本
uv run python --version

# 检查系统默认版本
/usr/bin/python3 --version

临时使用特定版本

对于单次运行需求，可直接指定版本执行：

uv run --python 3.13 python temp-script.py

目录结构说明

uv 创建的典型隔离环境包含：

• .venv/：虚拟环境目录
• pyproject.toml：项目配置文件
• .python-version：版本锁定文件

所有 Python 解释器默认安装在用户目录：
~/.local/share/uv/python/