submodule 与 monorepo：子模块机制、大仓库优化与多仓取舍

主项目 myapp/
  ├─ app.js
  ├─ .gitmodules        <- 记录子模块 URL 与本地路径的映射
  └─ libs/core/         <- 子模块（独立仓库，固定在其某次提交上）

echo '===== submodule：把另一个仓库作为子目录引用 ====='
git config --global protocol.file.allow always
git init -q --bare -b main /tmp/libcore.git
git clone -q /tmp/libcore.git libwork && cd libwork
echo 'API v1' > api.txt && git add . && git commit -q -m "lib: v1"
git push -q -u origin main 2>/dev/null
cd ..
 
echo '在主项目里把上面的库作为 submodule 引入（记录的是库当前 main=v1 的哈希）：'
git init -q -b main app && cd app
git submodule add -q /tmp/libcore.git libs/core
echo '.gitmodules 记录了子模块的 URL 与本地路径：'
cat .gitmodules
echo
echo 'git submodule status（前面空格=已初始化且干净）：'
git submodule status
echo "app 记录的子模块 gitlink：$(git ls-files --stage libs/core)"
echo
echo '提交主项目（注意：提交的是子模块的「引用哈希」，不是内容）：'
git add . && git commit -q -m "chore: 引入 core 库子模块"
cd ..
 
echo
echo '===== 克隆含 submodule 的项目需要 --init ====='
git clone -q app app2 && cd app2
echo "app2 记录的子模块 gitlink（克隆时一并复制）：$(git ls-files --stage libs/core)"
echo '刚克隆时子模块目录是空的（只复制了 gitlink，没复制内容）：'
test -s libs/core/api.txt && echo '有内容' || echo '（空，需要 init）'
echo '执行 git submodule update --init 拉取子模块内容：'
git submodule update --init -q
echo "现在 libs/core 内容是（应为引入时的 v1）：$(cat libs/core/api.txt)"
cd ..
 
echo
echo '===== 更新子模块到新版本 ====='
cd libwork && echo 'API v2' > api.txt && git add . && git commit -q -m "lib: v2" && git push -q 2>/dev/null && cd ..
cd app2
echo '在主项目里把子模块更新到上游最新：'
git submodule update --remote -q
git add libs/core && git commit -q -m "chore: 升级 core 到 v2"
echo "主项目现在引用的子模块哈希变了：$(git ls-files --stage libs/core)"
echo "libs/core 内容（应为 v2）：$(cat libs/core/api.txt)"
cd ..

git clone <url> myproj && cd myproj
git submodule update --init --recursive   # --recursive 处理嵌套子模块
# 或者一步到位：
git clone --recurse-submodules <url> myproj

cd libs/core
git checkout main        # 先切到真正分支再改
# ... 修改、提交、push ...
cd ..
git add libs/core        # 把新哈希记录回主项目
git commit -m "bump core"

git config --file=.gitmodules submodule.libs/core.url <new-url>
git submodule sync        # 把 .gitmodules 的新 URL 同步到 .git/config

git subtree add --prefix=libs/core <url> main --squash   # 引入
git subtree pull --prefix=libs/core <url> main --squash  # 更新
git subtree push --prefix=libs/core <url> main          # 把改动推回子项目

echo '===== sparse-checkout：只检出需要的目录 ====='
git config --global protocol.file.allow always
git init -q --bare -b main /tmp/big.git
git init -q -b main bigwork && cd bigwork
git remote add origin /tmp/big.git
mkdir -p src/api src/web src/docs assets
echo 'api code' > src/api/a.js
echo 'web code' > src/web/w.js
echo 'doc' > src/docs/d.md
echo 'big asset' > assets/logo.bin
git add . && git commit -q -m "init big repo" && git push -q -u origin main 2>/dev/null
cd ..
 
echo '普通克隆：所有目录都下来了'
git clone -q /tmp/big.git full && cd full
echo "普通克隆后顶层内容：$(ls)"
cd ..
 
echo
echo '用 sparse-checkout 只检出 src/api 和 src/web：'
git clone -q /tmp/big.git sparse && cd sparse
git sparse-checkout init --cone
git sparse-checkout set src/api src/web
echo "sparse 克隆后工作区只含：$(find . -path ./.git -prune -o -type f -print | sort)"
echo '未检出的 src/docs 暂时看不到，但仍在仓库里（需要时再展开）'
cd ..
 
echo
echo '===== partial clone：先不下载文件内容 ====='
echo '用 --filter=blob:none 部分克隆（大仓库 CI/浅取常用）：'
git clone -q --filter=blob:none file:///tmp/big.git part
cd part
echo "是否 promisor 仓库（按需取对象）：$(git config remote.origin.promisor)"
echo '此时文件列表能看，但 blob 内容按需从源仓库现取：'
git ls-files
echo '查看某个文件内容（首次访问会按需 fetch）：'
cat src/api/a.js
cd ..