如何构建仅含依赖项的Python包？实现单pip install跨项目部署

可行性结论 #

完全可以构建这样一个仅封装依赖的Python元包（Meta Package），通过单个pip install命令就能一次性安装所有30个公开/私有依赖包。

1. 包架构设计 #

元包本身不需要任何业务代码，核心是声明依赖，最简架构如下：

my-deps-package/
├── pyproject.toml  # 核心配置文件
├── setup.cfg       # 可选补充配置（基于setuptools）
└── README.md       # 说明文档（可选但建议）

2. 除requirements外的必要文件 #

核心配置文件 #

• pyproject.toml：这是PEP 621规定的现代Python包标配配置文件，用来声明包的基础信息和依赖。示例内容：

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

[project]
name = "my-deps-package"
version = "0.1.0"
authors = [
  { name="Your Name", email="your@email.com" }
]
description = "Meta package to install all required dependencies for target project"
dependencies = [
  # 公开包直接写包名+版本约束
  "requests>=2.31.0",
  "numpy==1.26.0",
  # 私有包需指定安装源（私有PyPI或Git仓库）
  "my-private-package @ git+https://your-private-git-repo.com/my-private-package.git@v1.0.0",
  "another-private-package @ https://your-private-pypi.com/simple/another-private-package/==2.1.0"
]

• setup.cfg（可选）：若习惯setuptools传统配置方式，可用来补充分类信息、额外安装选项等，但当前pyproject.toml已能覆盖大部分核心需求。

可选但建议的文件 #

• README.md：说明元包用途、依赖清单、私有源配置要求等关键信息。
• LICENSE：若公开分发该元包，需添加对应开源许可证文件。

关键注意事项 #

• 私有包访问：安装者环境需能访问私有依赖的源（比如配置pip.conf/pip.ini指向私有PyPI，或拥有Git仓库的访问权限）。
• 版本锁定：若需保证多环境依赖一致，建议在dependencies中写入所有依赖的精确版本号。

替代方案（元包不适用场景） #

如果不想构建元包，可采用以下方式：

• 整理所有依赖（含私有包）到requirements.txt，执行pip install -r requirements.txt完成安装，私有包写法与元包一致。
• 使用pip-tools工具：将依赖声明在requirements.in，生成精确锁定版本的requirements.txt，便于维护和重复安装。

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