3D网格浮点压缩分支的GitHub管理方案及优化问询

一、现有分支策略的便捷优化方法 #

1. Submodule 批量管理技巧 #

• 用git submodule foreach命令批量操作所有子模块，比如批量拉取最新代码：git submodule foreach git pull origin main，批量初始化：git submodule foreach git init
• 开启Git自动递归子模块：执行git config --global submodule.recurse true，切换分支时会自动同步对应分支的子模块状态，无需手动清理缓存
• 每个分支只保留对应压缩库的子模块配置：修改各分支的.gitmodules文件，仅包含当前压缩类型需要的子模块，切换分支后执行git submodule sync && git submodule update --init --recursive，自动加载所需子模块

2. CMakeLists 解耦改造 #

• 将每个压缩类型的构建逻辑拆分为独立的CMake子模块（如cmake/modules/CompressZstd.cmake、cmake/modules/CompressGzip.cmake）
• 主CMakeLists通过构建参数判断加载对应模块：比如新增-DCOMPRESS_TYPE=ZSTD参数，主脚本根据该变量include对应的子模块，实现不同压缩类型的构建解耦
• 为每个分支配置CMake预设：在各分支的CMakePresets.json中写入对应压缩类型的默认参数，切换分支后直接构建无需手动传参

3. GitHub Actions 改为用户触发式 #

• 使用workflow_dispatch触发器替代自动触发，示例配置如下：

on:
  workflow_dispatch:
    inputs:
      compress_type:
        description: '选择要构建的压缩类型'
        required: true
        type: choice
        options:
          - zstd
          - gzip
          - draco
          - no-compression

• 用户可在GitHub页面手动选择压缩类型触发构建，同时可保留main分支的自动构建（如合并时触发全量对比测试）

二、更优的分支与项目架构策略 #

1. 单分支多配置替代多分支方案 #

• 放弃按压缩类型分分支的模式，改用main分支配合CMake选项+条件加载子模块：
  • 所有压缩库子模块统一纳入项目，通过-DENABLE_ZSTD=ON/OFF这类参数控制是否编译对应模块
  • 利用Git稀疏检出仅拉取当前需要的子模块：git submodule set-branch --branch main zstd && git sparse-checkout set zstd，减少本地存储负担
• 优势：无需频繁切换分支，避免子模块冲突，所有代码在同一分支维护，对比测试更便捷

2. 用Git Worktree隔离多分支环境 #

• 若坚持多分支策略，使用git worktree为每个压缩分支创建独立本地工作目录：
  • 执行git worktree add ../zstd-branch zstd，每个分支拥有单独的文件夹，子模块完全隔离，无需清理构建缓存
  • 每个工作区可独立配置CMake和构建缓存，互不干扰

3. 公共代码独立化 #

• 将3D网格/浮点数的读取、测试等非压缩相关逻辑提取为独立Git仓库，作为所有分支的公共子模块
• 每个压缩分支仅保留对应压缩算法的集成代码，缩小分支间差异，合并到main分支时更高效

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