如何在Python微服务Monorepo中配置导入以复用utils模块？

方案1：本地路径依赖（生产/开发通用推荐） #

放弃相对导入的思路，直接在API项目的pyproject.toml中将utils声明为本地路径依赖，这是Python包管理工具的标准做法：

# API项目的pyproject.toml
[tool.poetry.dependencies]
python = "^3.10"
# 指向utils模块的相对路径，develop=true开启开发模式（修改实时同步）
utils = { path = "../utils", develop = true }

如果用原生pip管理，可在API的requirements.txt中添加：

-e ../utils

或直接执行命令安装本地依赖：

pip install -e ../utils

方案2：临时调整Python路径（快速测试用） #

在API项目的入口文件开头，手动把utils的源码目录加入Python搜索路径，适合快速验证功能：

import sys
from pathlib import Path

# 拼接utils/src的绝对路径（根据你的实际目录结构调整层级）
utils_src = Path(__file__).parent.parent.parent / "utils" / "src"
sys.path.append(str(utils_src))

# 直接导入utils模块
from utils import common_validator

注意：这种方式维护性差，路径层级变动后容易失效，不建议长期使用。

方案3：Monorepo工作区管理（大规模项目适用） #

如果你的Monorepo包含多个子项目，用Poetry工作区统一管理更高效：

1. 在Monorepo根目录创建pyproject.toml：

[tool.poetry]
name = "monorepo-root"
version = "0.1.0"
packages = []

[tool.poetry.workspaces]
members = ["api", "utils"]  # 列出所有子项目目录

2. 在API项目的pyproject.toml中直接声明依赖：

[tool.poetry.dependencies]
utils = "^0.1.0"  # 直接用版本号，Poetry会自动关联工作区内的utils模块

核心注意事项 #

• 必须确保utils模块的pyproject.toml正确配置源码位置，示例：

  [tool.poetry]
  packages = [{ include = "utils", from = "src" }]
  

• 跨项目模块复用不要用Python原生相对导入，相对导入仅适用于同一个包内部的模块，跨项目场景必须通过包依赖机制实现。

内容的提问来源于stack exchange，提问作者TomerG