Git子模块拉取操作的完整指南

git clone 主仓库地址.git

# 方法1：克隆时递归拉取
git clone --recursive 主仓库地址.git
 
# 方法2：先克隆后初始化
git clone 主仓库地址.git
cd 主仓库目录
git submodule update --init --recursive

# 进入主仓库目录后执行
git submodule init  # 初始化本地配置文件

# 拉取子模块最新代码（默认指向记录的提交）
git submodule update --remote
 
# 切换子模块到特定分支（需先配置）
cd 子模块目录
git checkout 分支名
cd ..
git add 子模块目录
git commit -m "更新子模块版本"

git submodule add 仓库地址 子模块路径

# 移除子模块关联
git submodule deinit -f 子模块路径
# 删除子模块目录（谨慎操作）
git rm -f 子模块路径
# 提交修改
git commit -m "移除子模块"

git submodule update --init --recursive

# 清理无效子模块引用
rm -rf .git/modules/子模块名
git submodule sync
git submodule update --force

# 生成 ssh 密钥对
ssh-keygen -t ed25519
# 添加公钥到子模块仓库的部署密钥

# 进入子模块目录
git checkout 历史提交id
# 返回主仓库提交变更
git add 子模块目录
git commit -m "回退子模块版本"

# 对所有子模块执行命令
git submodule foreach "git pull origin main"

# 查看子模块同步状态
git submodule status
# 检查子模块是否有未提交的更改
git submodule foreach "git status --porcelain"

[submodule "子模块名"]
	ignore = dirty

# 修改子模块路径
git config -f .gitmodules submodule.子模块名.path 新路径
git submodule sync