0

0

Python 多包 monorepo 的管理工具

冰川箭仙

冰川箭仙

发布时间:2026-02-21 13:45:12

|

303人浏览过

|

来源于php中文网

原创

poetry 默认将当前目录视为项目根,pyproject.toml 所在处即主包位置;monorepo 中需cd进子包目录或用--directory指定路径执行poetry add,否则依赖误写入顶层配置。

python 多包 monorepo 的管理工具

poetry add 为什么总装到 root 包而不是子包?

因为 Poetry 默认把当前目录当项目根,pyproject.toml 在哪,它就认为哪个是“主包”。monorepo 里多个 pyproject.toml 并存时,你 cd 进错目录、或者没指定 --directorypoetry add 就会往顶层的 pyproject.toml 写依赖。

实操建议:

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

magento(麦进斗)
magento(麦进斗)

Magento是一套专业开源的PHP电子商务系统。Magento设计得非常灵活,具有模块化架构体系和丰富的功能。易于与第三方应用系统无缝集成。Magento开源网店系统的特点主要分以下几大类,网站管理促销和工具国际化支持SEO搜索引擎优化结账方式运输快递支付方式客户服务用户帐户目录管理目录浏览产品展示分析和报表Magento 1.6 主要包含以下新特性:•持久性购物 - 为不同的

下载
  • 进子包目录再运行命令:cd packages/my-utils && poetry add requests
  • --directory 显式指定路径:poetry add pytest --directory packages/my-api
  • 别在 monorepo 根目录下执行 poetry initpoetry add,除非你真想管理一个全局依赖池
  • 检查当前是否误启用了 Poetry 的“virtualenvs.in-project = true”——这会让它在每个子目录建 .venv,但依赖仍可能写错位置

poetry install 后子包无法 import?

不是安装失败,是 Poetry 默认不启用“editable install”(即 -e 模式)。子包没被 pip 以开发模式链接进 site-packages,Python 找不到它们。

实操建议:

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

  • 对每个子包单独执行:poetry install --no-root(先进入子包目录)
  • 或在子包 pyproject.toml 中确保 [tool.poetry.dependencies] 下没漏掉 python 版本约束,否则 poetry install 可能跳过它
  • 验证是否生效:运行 python -c "import my_utils; print(my_utils.__file__)",输出路径应指向你本地的 packages/my-utils/my_utils/__init__.py,而非 .venv/lib/...
  • 如果用 IDE(如 VS Code),重启 Python 解释器选择,它缓存了旧的 sys.path

如何让所有子包共享同一个虚拟环境?

Poetry 本身不支持“一个 venv 装多个独立 pyproject.toml”,但它允许你在根目录建一个“管理型”pyproject.toml,用 [tool.poetry.group.dev.dependencies][tool.poetry.group.test.dependencies] 统一管工具链,而各子包保持自己的依赖声明——关键在于不把子包当“依赖”硬塞进根项目。

实操建议:

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

  • 根目录 pyproject.toml 只含 dev 工具(pytest, black, mypy),不声明任何业务包
  • 各子包用 poetry add --group dev 管理自己需要的 dev 工具,互不影响
  • 运行测试时,cd 进子包目录再执行 poetry run pytest,它会自动用该子包的 pyproject.toml 解析依赖并激活对应环境
  • 避免用 poetry workspace —— Poetry 官方已弃用该功能,且从未真正支持多包 workspace

用 hatch 或 pdm 替代 poetry?

可以,但切换前得看清差异点:hatch 默认支持 workspace(hatch build --all + hatch env run --all),pdm 支持 pdm worktree 管理多项目,而 Poetry 的“单项目单 lock”模型在 monorepo 场景下天然吃力。

实操建议:

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

  • 如果已有大量 Poetry 配置,先试 poetry-plugin-monorepo(第三方插件),它提供 poetry monorepo lock 等命令,比换工具成本低
  • 新项目选 hatch:它的 pyproject.toml[tool.hatch.envs] 可为每个子包定义独立环境,且 hatch run api:test 自动匹配对应目录
  • 注意 hatch 的 build 默认不包含 src/ 结构,若子包用 src/my_pkg 布局,需在 [tool.hatch.build.targets.sdist] 中配 include = ["src/**"]
  • 别指望任何工具自动解决跨包类型提示(mypy 报 Module not resolved)——必须手动在每个子包的 pyproject.toml 里加 [tool.mypy] + plugins = ["mypy_django"] 类配置,或统一用 pyrightconfig.json
实际跑通的关键不在工具选型,而在接受“monorepo 的 Python 生态没有银弹”——每个子包仍是独立项目,只是共用 CI/CD 和版本策略。最常被忽略的是:IDE 缓存、shell 的 PYTHONPATH 干扰、以及 pip list 看到的包和 python -m site 实际加载的路径不一致。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

443

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

544

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

322

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

81

2025.09.10

pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

351

2023.10.09

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

426

2024.12.20

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

788

2024.12.23

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

361

2025.07.23

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

796

2026.02.13

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.4万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号