如何让Git克隆仓库时忽略指定目录？Git新手求助

你的需求完全可行，先解释下为什么.gitignore没用：.gitignore只对未被Git追踪的文件生效，而docs目录已经在远程仓库里（属于已追踪文件），所以加进.gitignore只会让本地Git忽略该目录的变更，根本解决不了克隆时跳过下载的问题。

推荐方案：Sparse Checkout（稀疏检出） #

这正是Git专门用来实现“只克隆仓库部分内容”的功能，分两种场景操作：

场景1：新克隆仓库时直接跳过docs

1. 用稀疏模式克隆仓库（--filter=blob:none是为了加速克隆，只拉取元数据）：

git clone --filter=blob:none --sparse <你的仓库URL>

2. 进入仓库目录：

cd <仓库名称>

3. 设置要保留的内容（/*表示包含根目录所有内容，!docs表示排除docs目录）：

git sparse-checkout set /* !docs

执行完后，本地仓库就不会有docs目录，但远程仓库里的docs依然保留。

场景2：已克隆的仓库，想要移除本地docs并以后不再拉取

1. 进入仓库目录：

cd <仓库名称>

2. 启用稀疏检出功能：

git config core.sparseCheckout true

3. 编辑.git/info/sparse-checkout文件（这个文件不会提交到远程，只作用于本地），添加以下内容：

/*
!docs

4. 应用设置，让本地移除docs目录：

git read-tree -mu HEAD

替代方案 #

如果觉得稀疏检出的规则管理有点麻烦，还可以考虑这两种方式：

• Git LFS：如果docs里是单个/多个大文件，把这些大文件用Git LFS托管。克隆仓库时默认不会下载LFS文件，需要查看时再手动拉取（git lfs pull）。但这个方案是针对大文件，不是整个目录。
• 子模块：把docs目录拆成独立的Git仓库，作为主仓库的子模块。用户克隆主仓库时默认不会拉取子模块，需要查看文档时再单独拉取子模块内容。适合docs本身是独立文档项目的场景，但子模块的日常管理会稍微复杂一点。

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