如何在 uv 驱动的 Python 单体仓库中全局调用项目定义的脚本

风雪大大_5276

风雪大大_5276

2026-11-21

255人浏览

原创

如何在 uv 驱动的 Python 单体仓库中全局调用项目定义的脚本

通过 uv run --project 显式指定项目根目录,即可在单体仓库任意位置运行任一子项目的 project.script,无需切换路径或重复安装。

通过 `uv run --project ` 显式指定项目根目录,即可在单体仓库任意位置运行任一子项目的 `project.script`,无需切换路径或重复安装。

在使用 uv 管理的 Python 单体仓库(monorepo)中,各子项目通常以独立包形式组织(如 projects/aaa/, projects/bbb/),并各自在 pyproject.toml 中通过 [project.scripts] 定义可执行入口:

# projects/aaa/pyproject.toml
[project.scripts]
aaa = "aaa.cli:main"

此时,仅当工作目录位于 projects/aaa/ 时,uv run aaa 才能成功解析并执行;一旦离开该目录(例如在仓库根目录或其它子项目中),uv 将因无法自动发现对应项目配置而报错 Command not found: aaa。

根本原因在于:uv run 默认仅在当前目录及其向上递归路径中查找 pyproject.toml,且仅加载 当前工作目录所在项目 的脚本定义。它不会自动扫描整个 workspace 或索引所有子项目的 project.scripts。

使用 Claude Agent SDK 将绑定的 Claude 代码会话嵌入到 Python 自动化中
使用 Claude Agent SDK 将绑定的 Claude 代码会话嵌入到 Python 自动化中

当现有的脚本或服务需要将作用域化的仓库工作委托给 Claude Code 并以编程方式消费结构化响应时,请使用 Claude Agent SDK for Python。

下载

✅ 正确解法:显式指定项目上下文
使用 --project 标志手动告知 uv 目标项目的根路径(即包含其 pyproject.toml 的目录):

# 在仓库根目录下,直接运行 aaa 子项目的脚本
uv run --project projects/aaa aaa

# 在 projects/bbb/ 目录下,运行同仓库内另一个项目
uv run --project ../aaa aaa

# 支持绝对路径(推荐用于 CI 或固定脚本)
uv run --project "$PWD/projects/aaa" aaa

⚠️ 注意事项:

  • --project 路径必须指向一个有效的、含 pyproject.toml 的 Python 项目根目录(不要指向 src/ 或 pyproject.toml 文件本身);
  • 该选项不触发安装——uv run 会按需解析依赖并临时构建环境,确保脚本在隔离、可复现的环境中执行;
  • 若脚本依赖未声明的包或存在版本冲突,错误仍会在运行时暴露,建议配合 uv lock 和 uv sync 保障依赖一致性;
  • 目前 uv 不支持全局注册所有子项目脚本(类似 pipx 的 workspace 模式),因此无法实现真正意义上的“无参数 uv run aaa 全局可用”。若需更高层抽象,可封装 shell 函数或 Makefile:
# Makefile(置于仓库根目录)
.PHONY: run-aaa run-bbb
run-aaa:
    uv run --project projects/aaa aaa

run-bbb:
    uv run --project projects/bbb bbb

综上,--project 是 uv 原生、轻量且可靠的方式,让单体仓库中各子项目的脚本具备跨目录可访问性,兼顾灵活性与确定性,是现代 Python 工作流中推荐的标准实践。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

驱动精灵
驱动精灵

驱动精灵基于驱动之家十余年的专业数据积累,驱动支持度高,已经为数亿用户解决了各种电脑驱动问题、系统故障,是目前有效的驱动软件,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

python

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.07.20

1971

4

python能做什么
python能做什么

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

2023.07.25

5644

7

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

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

2023.07.31

1909

3

python教程
python教程

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

2023.08.03

34577

23

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

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

2023.08.04

4027

5

python eval
python eval

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

2023.08.04

4047

5

scratch和python区别
scratch和python区别

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

2023.08.11

1303

5

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

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

2023.08.10

636

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

3143

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程