讲师中心 微信公众号

工具推荐

视频效率加速
SoundView
SoundView

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

AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

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

风雪大大_5276

风雪大大_5276

发布时间:2026-11-21 15:07:40

|

255人浏览过

|

来源于php中文网

原创

如何在 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

⚠️ 注意事项:

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

  • --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 工作流中推荐的标准实践。

相关文章

驱动精灵
驱动精灵

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

下载

相关标签:

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

热门AI工具

更多
豆包大模型

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

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

PixPix
PixPix Hot

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

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

DeepSeek

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

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

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

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

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

相关专题

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

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

1971

2023.07.20

python能做什么
python能做什么

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

5644

2023.07.25

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

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

1909

2023.07.31

python教程
python教程

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

34577

2023.08.03

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

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

4027

2023.08.04

python eval
python eval

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

4047

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

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

0

2026.11.20

热门下载

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

精品课程

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

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