uv不内置python安装功能,需先确保系统已安装目标版本(如3.11),再用uv venv --python 3.11创建虚拟环境,最后激活并验证python --version。

在使用 uv 管理 Python 项目依赖时,需要为不同项目指定特定 Python 版本(比如 3.9 测试兼容性、3.12 用新语法),但 uv 本身不内置 Python 版本安装功能,必须依赖系统已有的 Python 解释器路径或外部工具配合才能完成版本切换。
确认本地已安装目标 Python 版本
uv 不会自动下载或安装 Python,它只识别并使用你系统中已存在的 Python 可执行文件。先运行 py --list(Windows)或 pyenv versions(macOS/Linux + pyenv)或 ls /usr/bin/python* 查看可用版本。若目标版本(如 python3.11)未出现,需先通过 python.org、pyenv、conda 或系统包管理器安装。
这一步跳过会导致后续所有切换操作失败,uv 会报错 No Python interpreter found matching request。
使用 uv 创建指定 Python 版本的虚拟环境
方法一:通过 --python 参数显式指定解释器路径
运行 uv venv .venv --python python3.11。uv 会自动在 PATH 中查找名为 python3.11 的可执行文件;若该名称不存在,可提供绝对路径,例如 uv venv .venv --python /opt/homebrew/bin/python3.11。
方法二:使用 Python 版本标识符(推荐,更简洁)
直接写小版本号,如 uv venv .venv --python 3.11。uv 会按顺序搜索:python3.11 → python3.11m → python3.11d → python3.11-tk,匹配到第一个即用。注意:这个机制依赖系统 PATH 或 pyenv/shim,【若 pyenv 未初始化或 shell 配置未生效,此处会找不到】。
激活虚拟环境后验证 Python 版本
第一步:执行 source .venv/bin/activate(Linux/macOS)或 .venv\Scripts\Activate.ps1(Windows PowerShell)
第二步:运行 python --version
第三步:检查输出是否为你期望的版本号,例如 Python 3.11.9。如果显示的是系统默认版本(如 3.9),说明前两步中指定的 Python 路径未被正确识别,需回到上一节重新核对解释器是否存在且可执行。
这一步不可跳过——仅创建虚拟环境不等于已切换,必须激活后才能生效。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











