如何在多包Python项目中通过Git分支单独安装指定包？

当然可以实现，以下是几种实用的解决方法：

方法1：用pip原生的子目录指定语法 #

这是最简单直接的方式，不需要修改仓库任何内容。在Git URL后追加#subdirectory=子包文件夹路径，同时可以通过@分支名指定目标分支。

比如你的仓库地址是https://github.com/xxx/your-project.git，要安装dev分支下package-a文件夹里的包，命令如下：

pip install git+https://github.com/xxx/your-project.git@dev#subdirectory=package-a

pip会自动跳转到指定的子目录，读取该目录下的setup.py（或pyproject.toml）完成安装。

方法2：本地克隆指定子目录后安装（适合频繁操作场景） #

如果需要多次安装同一个子包，可以用Git的稀疏检出功能只拉取目标子目录，再本地安装：

# 克隆仓库（仅拉取元数据，不下载所有文件）
git clone --filter=blob:none --sparse https://github.com/xxx/your-project.git
cd your-project
# 设置只检出目标子包目录
git sparse-checkout set package-a
# 切换到目标分支
git checkout dev
# 安装子包
pip install .

这种方法适合需要对子包做本地修改后再安装的场景，但步骤比第一种多。

方法3：根目录添加统一配置（适合长期维护） #

如果想统一管理所有子包，可以在项目根目录添加setup.py或pyproject.toml，将子包设为可选依赖。比如根目录的setup.py可以这么写：

from setuptools import setup

setup(
    name="your-root-project",
    version="0.1.0",
    extras_require={
        "package-a": ["package-a @ file://./package-a"],
        "package-b": ["package-b @ file://./package-b"],
    }
)

之后安装指定子包的命令就变成：

pip install git+https://github.com/xxx/your-project.git@dev[package-a]

这种方式能让用户更清晰地看到项目包含的所有子包，但需要修改仓库根目录的配置。

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