讲师中心 微信公众号

工具推荐

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

低成本歌曲 MV、视频生成

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

SoundView
SoundView

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

怎么用Python uv安装GitHub上的开源库

大涛吖_3749

大涛吖_3749

发布时间:2026-11-20 10:01:17

|

136人浏览过

|

来源于php中文网

原创

使用 uv 安装 github 上的开源库,最直接的方法是在 pip install 命令中指定 git 仓库的 https 或 ssh url。例如运行 uv pip install git+https://github.com/user/repo.git 即可将代码克隆到本地并安装。如果需要安装特定的分支、标签或提交版本,可以在 url 后附加 @branch_name 或 @commit_hash 来锁定版本。此外,如果该库在项目中作为依赖存在,也可以直接在 pyproject.toml 文件的 [project.dependencies] 或 [project.optional-dependencies] 中添加对应的 git url 字符串,然后运行 uv sync 进行解析和安装。

怎么用Python uv安装GitHub上的开源库

如何安装特定分支或提交的代码

当需要安装非默认分支(如 dev)或特定历史版本的代码时,只需在 Git URL 后添加 @ 符号及对应的标识符。这种方式允许你精确控制安装的代码快照,避免因为上游仓库更新导致的行为不一致。对于开发者来说,这通常用于测试新功能或回退到已知稳定的旧版本。执行该操作时,uv 会像处理普通包一样处理这些引用,将其解析为具体的源代码并构建安装。

怎么用Python uv安装GitHub上的开源库

uv pip install git+https://github.com/psycopg/psycopg.git@v3.1.x

上述命令会安装 psycopg 仓库中符合 v3.1.x 标签的最新提交。如果希望安装某个具体的 commit hash,可以将 @v3.1.x 替换为 @a1b2c3d4。安装完成后,可以通过 uv pip show psycopg 查看已安装的版本信息,确认其指向了正确的 Git 引用。这种基于 URL 的安装方式不依赖于 PyPI,完全从源码构建,因此适用于尚未发布到包管理器的实验性代码。

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

使用 CI Doctor 调查失败的 GitHub Actions 运行记录
使用 CI Doctor 调查失败的 GitHub Actions 运行记录

使用 GitHub Next 的 CI Doctor 工作流来监视 GitHub Actions 运行、拉取失败日志、追踪重复模式,并打开带有具体下一步操作的调查问题。这是供代理作为 CI 失败调查员使用的,而不是用于将 GitHub Agentic Workflows 列为产品。

下载

如何在 pyproject.toml 中声明 Git 依赖

在项目管理中,将 Git 仓库作为依赖写入配置文件是更规范的做法。在 pyproject.toml 文件中,可以使用标准的 PEP 508 格式来描述 Git 依赖。具体做法是在依赖列表中直接写入完整的 Git URL 字符串。这种方法的好处是依赖关系被明确记录在项目配置中,其他协作者或 CI/CD 环境只需运行 uv sync 即可复现相同的环境。需要注意的是,Git URL 必须包含协议前缀(如 git+https://),且不能包含空格。

怎么用Python uv安装GitHub上的开源库

[project]
name = "my-project"
version = "0.1.0"
dependencies = [
    "requests",
    "git+https://github.com/user/special-lib.git@main"
]

保存上述 pyproject.toml 后,运行 uv sync。uv 会识别出 special-lib 是一个 Git 依赖,自动克隆对应分支的代码,并在虚拟环境中安装它。与命令行安装相比,这种方式确保了依赖树的确定性。如果后续需要更新该库到最新状态,只需再次运行 uv sync,它会检查远程仓库是否有新的提交并相应更新。若需锁定版本以防意外更新,可结合 uv.lock 文件使用,该文件会记录当前解析出的确切 Git commit hash。

安装带有子目录的 Git 仓库

有些大型项目采用多包结构,即一个 Git 仓库中包含多个独立的 Python 包,分布在不同的子目录下。在这种情况下,直接使用完整的 Git URL 安装可能会失败,因为 uv 无法确定要安装哪个子包。解决这个问题的方法是使用 #subdirectory=path/to/subdir 后缀来指定具体的子目录路径。这使得 uv 能够正确定位到目标包的 pyproject.toml 或 setup.py 文件,从而完成安装。这对于使用 monorepo 架构的团队尤其有用,可以灵活地引用内部共享组件。

uv pip install "git+https://github.com/monorepo/project.git#subdirectory=libs/shared-lib"

该命令指示 uv 克隆整个仓库,但仅安装 libs/shared-lib 目录下的内容。安装成功后,该子包会被视为一个独立的依赖项加入虚拟环境。如果在 pyproject.toml 中声明,写法类似:shared-lib = { git = "https://github.com/monorepo/project.git", subdirectory = "libs/shared-lib" }。这种方式保持了仓库的完整性,同时实现了模块化的依赖管理。开发者应注意子目录路径的正确性,任何拼写错误都会导致安装失败。

热门AI工具

更多
UpDream
UpDream Hot

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

DeepSeek

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

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

豆包大模型

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

WorkBuddy

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

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

相关专题

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

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

1971

2023.07.20

python能做什么
python能做什么

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

5604

2023.07.25

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

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

1909

2023.07.31

python教程
python教程

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

34257

2023.08.03

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

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

4007

2023.08.04

python eval
python eval

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

4007

2023.08.04

scratch和python区别
scratch和python区别

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

1303

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