通过 uv 工具在项目初始化、现有项目切换及多版本管理中精准指定 Python 版本。涵盖命令行参数设置、虚拟环境重建、pyproject.toml 约束声明及服务器部署场景。利用 uv python install/list/pin 命令配合锁文件机制，确保开发、测试与生产环境的一致性，解决依赖兼容性与团队版本统一问题。
在真实开发中，指定 Python 版本至关重要：
在项目初始化阶段指定 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
执行后，uv 会：
pyproject.toml 中记录 Python 版本约束如果你的项目已经创建，但需要更改 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
重要提示：更改 Python 版本后，某些依赖可能需要重新安装或选择兼容版本。务必运行 uv sync 让 uv 重新解析依赖树。
对于需要管理多个 Python 版本的高级用户：
# 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 中声明 Python 版本要求，这是团队协作的最佳实践：
# 在 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 系列的任何版本
当其他人运行 uv sync 时，uv 会检查此约束并尝试使用兼容的 Python 版本。
服务器环境与本地类似，但可能需要先安装特定 Python 版本：
# 在 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
像 pyenv 一样，uv 也支持 .python-version 文件：
# 创建版本文件
echo "3.10.11" > .python-version
# uv 会自动使用此版本
uv sync
uv init --python X.Y 从一开始就固定版本pyproject.toml 中添加 requires-python 字段uv.lock 与 Python 版本匹配，不同版本可能需要重新生成actions/setup-python@v4| 场景 | 推荐方法 | 示例命令 | 适用情况 |
|---|---|---|---|
| 新项目 | --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 的工作流 |
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online