如何构建并正确引用可编辑的本地Python共享模块？

核心原因 #

你遇到的问题出在两个关键点：模块目录结构不规范，以及pyproject.toml缺少可编辑安装所需的构建配置。正常安装（不带-e）会自动打包并安装模块，但可编辑安装需要明确的包结构和构建后端支持才能创建正确的链接。

具体解决步骤 #

1. 调整模块目录结构 #

确保你的data_audit_shared模块目录下存在与模块名同名的Python包文件夹，并且包含__init__.py（即使是空文件也可以）：

data_audit_shared/
├── pyproject.toml
└── data_audit_shared/
    ├── __init__.py
    └── 你的业务代码文件.py

没有这个同名包目录的话，pip无法在可编辑模式下将模块链接到Python的site-packages路径中，自然会提示找不到模块。

2. 完善pyproject.toml的构建配置 #

在现有的[project]部分下方添加构建系统配置，指定支持可编辑安装的后端（推荐用setuptools）：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

setuptools 61.0及以上版本支持PEP 660标准的可编辑安装，这是本地模块能被正确链接的必要条件。

3. 重新执行可编辑安装 #

先卸载已安装的版本，再重新安装：

pip uninstall -y data_audit_shared
pip install -e ../../data_audit_shared

安装完成后可以用pip list验证，你会看到data_audit_shared条目后标注着editable project location: ../../data_audit_shared，说明可编辑安装已生效。

关于Git仓库可正常工作的原因 #

Git仓库中的模块通常已经具备规范的目录结构（同名包文件夹+构建配置），符合可编辑安装的要求，所以用-e git+url的语法能正常工作；而你的本地模块恰好缺少这两个关键要素，才会出现本地路径可编辑安装失败的情况。

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