讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

SoundView
SoundView

字幕擦除翻译、配音口型同步

剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

怎么用Python uv管理多版本Python共存

浅婷酱_4235

浅婷酱_4235

发布时间:2026-11-19 11:02:26

|

848人浏览过

|

来源于php中文网

原创

使用 uv 管理多版本 python 共存的核心方法是利用其内置的 python 安装器功能,通过 uv python install <version></version> 命令下载并注册不同版本的解释器,随后在项目中通过 uv sync --python <version></version> 或设置 .python-version 文件来指定当前环境使用的具体版本。这样做可以让 uv 自动处理虚拟环境的创建与隔离,确保每个项目都能锁定到特定的 python 版本,而无需手动配置系统环境变量或依赖第三方工具如 pyenv。

怎么用Python uv管理多版本Python共存

如何安装并切换特定版本的 Python

要开始使用多版本共存,首先需要安装目标版本的 Python。uv 会自动从官方源下载对应操作系统的二进制包,并将其安装在本地缓存目录中,同时建立符号链接或注册表项以便系统识别。例如,运行 uv python install 3.10 和 uv python install 3.12 后,系统中就存在了两个可用的 Python 版本。接着,可以通过 uv python list 查看已安装的版本列表,并使用 uv run --python 3.10 <script></script> 临时指定版本运行脚本,或者在项目根目录创建 .python-version 文件写入 3.10,这样 uv sync 就会自动使用该版本创建虚拟环境。

怎么用Python uv管理多版本Python共存

uv python install 3.10
uv python install 3.12
uv python list
mkdir myproject
cd myproject
uv init
uv add requests
uv sync --python 3.10
uv run python -c "import sys; print(sys.version)"
uv sync --python 3.12
uv run python -c "import sys; print(sys.version)"

上述代码执行后,首先安装两个版本,然后初始化项目并添加依赖。第一次同步指定 3.10 版本,运行脚本输出应包含 3.10.x;第二次同步指定 3.12 版本,运行脚本输出应包含 3.12.x。这验证了 uv 能够根据参数切换底层解释器并创建独立的虚拟环境。

立即学习“Python免费学习笔记(深入)”;

Python健壮编程
Python健壮编程

编写可靠Python代码,避免可变默认值、导入陷阱与运行时意外

下载

如何在项目中固定 Python 版本

在团队协作或 CI/CD 环境中,固定项目所使用的 Python 版本至关重要。uv 支持通过 .python-version 文件声明项目所需的最低或精确版本。当团队成员在项目目录下运行 uv sync 时,如果本地未安装指定版本,uv 会提示并询问是否自动安装,或者你可以预先通过 uv python install 准备好所有必要版本。这种方式比传统的 requirements.txt 更进了一步,因为它不仅管理包依赖,还直接管理解释器本身,消除了“在我机器上能跑”的环境差异问题。

怎么用Python uv管理多版本Python共存

# .python-version
3.11

# 终端命令
uv sync
uv run python main.py

在这个场景中,.python-version 文件明确指定了 3.11。运行 uv sync 后,uv 会检查本地是否有 3.11 版本,若无则安装,若有则复用。随后 uv run 会在该版本创建的虚拟环境中执行 main.py。这种机制确保了开发、测试和生产环境的一致性,避免了因系统默认 Python 版本升级导致的兼容性问题。

基于 uv sync 命令的输入条件与结果分析

当在项目中执行 uv sync 命令时,其行为取决于当前目录是否存在 .python-version 文件以及是否通过命令行传入了 --python 参数。如果两者均未指定,uv 会使用系统默认找到的第一个可用 Python 版本。如果指定了 --python 3.10,即使存在 .python-version 文件,命令行参数通常具有更高优先级(具体行为可能随版本更新略有调整,但通常显式参数优先)。结果是,uv 会创建一个指向指定版本解释器的虚拟环境,并安装 pyproject.toml 中定义的依赖。若指定版本未安装,uv 会尝试自动下载,除非设置了 UV_PYTHON_DOWNLOADS=manual 环境变量。这一过程完全自动化,无需用户干预路径配置。

热门AI工具

更多
花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

笔灵降AI

一款AI论文写作工具,主要用于论文降AI神器,适配知网及维普!一键降至安全线,100%保留原文格式;无口语化问题,文风更学术,降后字数控制最佳!,适合需要提升相关任务效率的用户。

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

1951

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

5564

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1889

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

33997

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3987

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

3987

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

1283

2023.08.11

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

636

2023.08.10

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

20

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

让uv管理Python的一切
让uv管理Python的一切

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn