能否仅检出单个分支作为Git子模块，仅下载该分支文件以规避完整仓库开销？

当然可以！Git 完全支持只拉取特定分支作为子模块，还能通过浅克隆来避免下载整个仓库的历史和多余分支，完美匹配你只想获取dist分支编译后JS文件的需求。下面是具体实现步骤：

1. 直接添加指定分支的浅克隆子模块 #

在主仓库的工作目录中，使用git submodule add命令时，加上两个关键参数：

• -b dist：明确指定要跟踪的分支为dist
• --depth 1：只克隆该分支的最新一次提交（不下载完整历史）

执行命令如下：

git submodule add -b dist --depth 1 <目标仓库的URL> <本地存放子模块的路径>

举个例子，如果你的JS库仓库地址是git@example.com:xxx/js-lib.git，想把它放在主仓库的libs/js-dist目录下，命令就是：

git submodule add -b dist --depth 1 git@example.com:xxx/js-lib.git libs/js-dist

执行后，你只会看到dist分支下的编译文件，不会下载master分支的源码和开发文件，开销极小。

2. 克隆主仓库后初始化子模块 #

如果是其他人克隆了你的主仓库，需要初始化子模块时，同样可以用浅克隆的方式避免多余下载：

git submodule update --init --recursive --depth 1

3. 更新子模块到最新版本 #

之后如果dist分支有更新，你可以用以下命令拉取最新的编译文件，同时保持浅克隆状态：

git submodule update --remote --depth 1

--remote参数会让子模块拉取远程dist分支的最新内容，--depth 1确保不会下载多余的历史提交。

注意事项 #

• 浅克隆的子模块没有完整的提交历史，如果你之后需要切换分支或查看历史，可执行git fetch --unshallow解除浅克隆，但对你的使用场景来说大概率不需要。
• 确保远程仓库的dist分支确实存在且包含你需要的编译后文件。
• 提交主仓库时，子模块的引用会被一并提交，其他协作者执行上述初始化命令就能同步获取到dist分支的内容。

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