# 添加子模块
$ git submodule add https://github.com/lib/library.git libs/library

# 指定分支
$ git submodule add -b main https://github.com/lib/library.git libs/library

# 结果：创建 .gitmodules 文件和 libs/library 目录
$ cat .gitmodules
[submodule "libs/library"]
    path = libs/library
    url = https://github.com/lib/library.git
    branch = main

# 方法 1：克隆后初始化子模块
$ git clone https://github.com/user/project.git
$ cd project
$ git submodule init
$ git submodule update

# 方法 2：一步完成
$ git clone --recursive https://github.com/user/project.git

# 方法 3：克隆后递归初始化
$ git clone https://github.com/user/project.git
$ cd project
$ git submodule update --init --recursive

# 更新所有子模块到最新提交
$ git submodule update --remote

# 更新特定子模块
$ git submodule update --remote libs/library

# 更新并合并
$ git submodule update --remote --merge

# 更新并变基
$ git submodule update --remote --rebase

# 进入子模块目录
$ cd libs/library

# 子模块有独立的 Git 仓库
$ git status
$ git checkout main
$ git pull

# 回到主仓库
$ cd ../..

# 查看子模块状态
$ git submodule status
 abc1234 libs/library (heads/main)

# 提交子模块变更
$ git add libs/library
$ git commit -m "Update library submodule to latest"

# 1. 从 .gitmodules 删除配置
$ git config -f .gitmodules --remove-section submodule.libs/library

# 2. 从暂存区删除
$ git rm --cached libs/library

# 3. 删除子模块目录
$ rm -rf libs/library
$ rm -rf .git/modules/libs/library

# 4. 提交变更
$ git commit -m "Remove library submodule"

# 添加子树（前缀目录）
$ git subtree add --prefix=libs/library https://github.com/lib/library.git main --squash

# --squash 表示压缩子仓库历史为一个提交

# 拉取子树最新代码
$ git subtree pull --prefix=libs/library https://github.com/lib/library.git main --squash

# 推送本地修改到上游仓库
$ git subtree push --prefix=libs/library https://github.com/lib/library.git main

# 将某个子目录的历史分离为独立分支
$ git subtree split --prefix=libs/library --branch=library-split

# 推送到独立仓库
$ git push https://github.com/lib/library.git library-split:main

# Git Sparse Checkout（稀疏检出，只检出部分目录）
$ git clone --no-checkout https://github.com/org/monorepo.git
$ cd monorepo
$ git sparse-checkout init --cone
$ git sparse-checkout set services/api libs/shared
$ git checkout main

# 或使用 Git 2.25+ 的简化方式
$ git clone --filter=blob:none --sparse https://github.com/org/monorepo.git
$ cd monorepo
$ git sparse-checkout set services/api libs/shared

# 子模块默认处于 detached HEAD 状态
$ cd libs/library
$ git status
HEAD detached at abc1234

# 切换到分支解决
$ git checkout main
$ git pull

# 更新子模块时遇到冲突
$ git submodule update --remote --merge
CONFLICT (content): Merge conflict in libs/library

# 进入子模块解决冲突
$ cd libs/library
$ git merge --abort    # 或手动解决冲突
$ git checkout main    # 切换到正确分支
$ cd ../..
$ git add libs/library
$ git commit -m "Resolve submodule conflict"