如何高效组织由多个独立Git仓库构成的多库项目？

1. 采用Git子模块统一管理依赖 #

将所有GUI/后端依赖库设为主仓库（比如gui或新建项目根仓库）的子模块，开发者只需一次克隆就能拉取所有代码：

• 配置子模块（在主仓库执行）：

  # 创建对应目录结构
  mkdir -p gui-libs backend/libs
  # 添加GUI依赖库
  git submodule add <gui-lib-1地址> gui-libs/lib1
  git submodule add <gui-lib-N地址> gui-libs/libN
  # 添加后端及依赖
  git submodule add <backend地址> backend
  git submodule add <backend-lib-1地址> backend/libs/lib1
  git submodule add <backend-lib-N地址> backend/libs/libN
  # 提交子模块配置
  git add .gitmodules gui-libs backend
  git commit -m "Add all submodules"
  

• 拉取代码简化为：

  git clone --recursive <主仓库地址>
  # 后续更新子模块
  git submodule update --remote
  

• 搭配批量构建脚本build.sh：

  #!/bin/bash
  # 构建后端依赖
  for dir in backend/libs/*; do
      [ -d "$dir" ] && pushd "$dir" && qmake && make && popd
  done
  # 构建后端
  pushd backend && qmake && make && popd
  # 构建GUI依赖
  for dir in gui-libs/*; do
      [ -d "$dir" ] && pushd "$dir" && qmake && make && popd
  done
  

2. 使用Git工作区集中管理多仓库 #

通过Git Worktrees在一个根目录下挂载所有独立仓库，避免重复克隆：

• 初始化步骤：

  mkdir project-root && cd project-root
  git init
  # 挂载各个仓库到对应目录
  git worktree add gui <gui仓库地址>
  git worktree add gui-libs/lib1 <gui-lib1地址>
  git worktree add backend <backend地址>
  git worktree add backend-libs/lib1 <backend-lib1地址>
  # 批量更新所有仓库
  git worktree list | awk '{print $1}' | xargs -I {} git -C {} pull
  

• 同样可以复用上面的build.sh完成批量构建。

3. 编写一键自动化脚本 #

直接写一个setup.sh脚本，把克隆、更新、构建全流程自动化，新同事只需运行一次：

#!/bin/bash

# 定义所有仓库的路径和地址
REPOS=(
  "gui <gui仓库地址>"
  "gui-libs/lib1 <gui-lib1地址>"
  "gui-libs/libN <gui-libN地址>"
  "backend <backend地址>"
  "backend-libs/lib1 <backend-lib1地址>"
  "backend-libs/libN <backend-libN地址>"
)

# 克隆/更新所有仓库
for repo in "${REPOS[@]}"; do
  dir=$(echo "$repo" | cut -d' ' -f1)
  url=$(echo "$repo" | cut -d' ' -f2)
  mkdir -p "$(dirname "$dir")"
  if [ ! -d "$dir/.git" ]; then
    git clone "$url" "$dir"
  else
    echo "仓库 $dir 已存在，执行更新..."
    git -C "$dir" pull
  fi
done

# 批量构建
echo "开始构建后端依赖..."
for dir in backend-libs/*; do
  [ -d "$dir" ] && pushd "$dir" && qmake && make && popd
done

echo "开始构建后端..."
pushd backend && qmake && make && popd

echo "开始构建GUI依赖..."
for dir in gui-libs/*; do
  [ -d "$dir" ] && pushd "$dir" && qmake && make && popd
done

echo "所有构建完成！"

给脚本添加执行权限：chmod +x setup.sh，运行./setup.sh即可完成全部操作。

4. 用包管理器替代源码克隆（可选） #

如果项目是C++技术栈，可以用Conan、Vcpkg这类包管理器，将依赖库打包上传到私有包仓库，开发者只需安装对应包再构建主项目，彻底省去源码克隆步骤。

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