无网络环境下如何将目录设置为Git子模块？

不需要依赖GitHub这类远程平台，直接用本地文件路径或服务器内的裸仓库就能完成子模块的创建与后续管理，全程在服务器内部操作，不用来回传文件。

核心操作步骤（单服务器场景） #

假设你的主代码仓库路径是/app/main-repo，要把其中的sub-module-a目录转为子模块：

1. 初始化子目录为独立Git仓库

cd /app/main-repo/sub-module-a
git init
git add .
git commit -m "Initial commit for sub-module-a"

2. 在主仓库中配置子模块
   回到主仓库目录，先移除对子目录的Git跟踪（不会删除实际文件），再添加为本地子模块：

cd /app/main-repo
# 取消主仓库对子目录的跟踪
git rm -r --cached sub-module-a
# 添加本地子模块，用子目录的Git仓库路径作为远程
git submodule add ./sub-module-a sub-module-a

3. 提交主仓库的配置变更

git add .gitmodules sub-module-a
git commit -m "Add sub-module-a as local submodule"

后续子模块管理 #

• 更新子模块内容：直接进入子模块目录，正常执行git add、git commit提交变更；回到主仓库后，执行git add sub-module-a并提交，就能记录子模块的最新版本。
• 添加新子模块：重复上述步骤，把新的子目录初始化Git仓库，再在主仓库中添加为子模块即可。

进阶方案：用裸仓库统一管理子模块（适合多机器同步或更规范的版本控制） #

如果后续需要在不同机器间同步子模块，或者想让子模块的管理更规范，可以在服务器上创建裸仓库作为子模块的中转：

1. 创建裸仓库

mkdir /app/git-remotes/sub-module-a.git
cd /app/git-remotes/sub-module-a.git
git init --bare

2. 把子模块仓库关联到裸仓库

cd /app/main-repo/sub-module-a
git remote add origin /app/git-remotes/sub-module-a.git
git push origin master

3. 更新主仓库的子模块远程路径
   编辑主仓库的.gitmodules文件，把url字段改成裸仓库的路径：

[submodule "sub-module-a"]
        path = sub-module-a
        url = /app/git-remotes/sub-module-a.git

然后提交这个变更：

git add .gitmodules
git commit -m "Update sub-module-a remote to bare repo"

这样后续管理子模块时，就可以通过裸仓库进行推送/拉取，和使用GitHub的逻辑完全一致，只是把远程地址换成了本地路径。

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