uv 精准指定 Python 版本的方法与实践 | 极客日志

uv 精准指定 Python 版本的方法与实践 | 极客日志

# 方式 1：使用 --python 参数直接指定
uv init --python 3.9
# 这将创建一个使用 Python 3.9 的新项目

# 方式 2：指定精确版本
uv init --python 3.11.5 

# 方式 3：使用 conda 环境中的 Python
uv init --python /path/to/your/python

# 1. 首先，删除旧的虚拟环境（重要！）
rm -rf .venv # Linux/macOS
# 或 rmdir /s .venv # Windows

# 2. 使用指定版本重新创建虚拟环境
uv python pin 3.10
# 方法 1：使用 pin 命令
# 或 uv venv --python 3.10
# 方法 2：重新创建 venv

# 3. 重新同步所有依赖
uv sync

# 1. 查看系统可用 Python 版本
uv python list
# 输出示例：
# - cpython-3.12.3 (C:\Users\...\Python\Python312\python.exe)
# - cpython-3.11.9 (C:\Users\...\Python\Python311\python.exe)
# - cpython-3.10.11 (C:\Users\...\Python\Python310\python.exe)

# 2. 安装特定的 Python 版本
uv python install 3.9
uv python install 3.11.8 # 安装精确版本

# 3. 设置项目默认 Python 版本（在项目目录内）
echo 'python = ">=3.10,<3.12"' >> pyproject.toml

# 在 pyproject.toml 的 [project] 部分添加
[project]
name = "my-project"
version = "0.1.0"
# 声明 Python 版本要求
requires-python = ">=3.9,<3.12" # 接受 3.9 到 3.11 的版本
# 或更精确的约束
requires-python = "~3.10.0" # 3.10.x 系列，x>=0
# 或单一版本
requires-python = "==3.11.*" # 3.11 系列的任何版本

# 在 Ubuntu 服务器上
sudo apt update
sudo apt install python3.10 python3.10-venv

# 然后在项目中使用
uv venv --python python3.10
uv sync

# 检查 uv 是否能找到指定版本
uv python find 3.9
# 如果没有，先安装
uv python install 3.9
# 列出所有已安装/可用的解释器
uv python list --all

# 创建版本文件
echo "3.10.11" > .python-version
# uv 会自动使用此版本
uv sync

场景	推荐方法	示例命令	适用情况
新项目	`--python` 参数	`uv init --python 3.11`	开始新项目时
现有项目	`uv python pin`	`uv python pin 3.10`	需要升级/降级版本
精确控制	`uv venv --python`	`uv venv --python 3.9.18`	需要特定小版本
团队协作	`pyproject.toml` 声明	`requires-python = ">=3.10"`	确保所有成员一致
多版本开发	`.python-version` 文件	`echo "3.11" > .python-version`	使用像 pyenv 的工作流