submodule deinit 是什么
git submodule deinit 反初始化一个子模块：清空它的工作区内容，并移除 .git/config 里的相关配置；父仓库记录（gitlink 与 .gitmodules）保持不变。它常用于临时停用某子模块或为彻底移除做准备，操作本身可逆——git submodule update --init 就能恢复。它还是子模块生命周期里的标准第一步：先反初始化再删除，比直接删目录安全得多。
基本信息
| 语法 | git submodule deinit [-f] <路径> |
|---|---|
| 效果 | 工作区清空、本地配置移除，父仓库记录不变 |
| 恢复 | git submodule update --init <路径> |
| 可逆性 | 轻量可逆操作 |
| 与移除的区别 | 彻底移除还需 git rm 与清理 .git/modules |
| 强制选项 | 改动未保存时用 -f，先核对内容再强制 |
典型使用场景
- 临时停用：CI 或特定开发场景不需要某子模块，先 deinit 省空间省时间
- 移除前置：准备走完整移除流程时先 deinit
- 构建隔离：只处理主仓库内容时避免子模块干扰
- 问题排查：怀疑子模块状态异常时反初始化再重新初始化恢复
- 迁移演练：调整子模块结构前先批量反初始化，观察构建影响面
常用示例
常用示例
git submodule deinit vendor/common # 清工作区并移除本地配置
git status --short # 查看父仓库是否干净
git submodule update --init vendor/common # 需要时恢复
git submodule status # 确认状态恢复deinit 与完整移除对比
| 维度 | deinit | 完整移除 |
|---|---|---|
| 工作区 | 清空 | 删除目录 |
| 配置 | 移除本地配置 | 删除配置与记录 |
| 可逆性 | 可逆 | 不可逆，需要重新添加 |
| 适用 | 临时停用 | 彻底下线 |
deinit 不删除 .git/modules 下的本地仓库：重复添加同名子模块时可能带出旧配置，彻底清理要按完整移除流程另行删除，避免下次添加踩同一个坑。
误 deinit 后构建目录缺失不用慌：update --init 即可恢复，不要手工去改 .gitmodules 文件，配置改动优先用 git submodule 系列命令。