git不支持原生命令只下载单个文件，所谓单文件下载实为绕过完整克隆：公开仓库常用curl+raw url，私有仓库推荐git archive --remote配合ssh/认证https。
Git 本身不支持只下载单个文件
Git 是分布式版本控制系统，设计上不提供“仅拉取某个文件”的原生命令。你看到的所谓“单文件下载”，本质是绕过完整克隆、用其他协议或服务接口实现的——比如 GitHub/GitLab 的 raw 链接，或 git archive 配合远程操作。直接运行 git clone 或 git pull 必然拉下整个仓库（至少是目标分支的全部历史对象）。
用 curl + GitHub/GitLab raw URL 下载指定文件（最常用）
适用于公开仓库，且你知道文件在仓库中的精确路径和分支名（如 main 或 master）。GitHub 的 raw 地址格式固定：
https://raw.githubusercontent.com/<owner>/<repo>/<branch>/<path-to-file></path-to-file></branch></repo></owner>
例如下载 README.md：
curl -O https://raw.githubusercontent.com/torvalds/linux/main/Documentation/ABI/README.md
- 注意：URL 中的分支名必须存在，
main和master常见但不通用，需确认实际分支名 - 私有仓库不可用此法，会返回 404 或重定向到登录页
- GitLab 地址格式为
https://gitlab.com/<owner>/<repo>/-/raw/<branch>/<path></path></branch></repo></owner>
用 git archive 从远程仓库导出单个文件（需 SSH 或 HTTPS 访问权限）
这个方法真正基于 Git 协议，适合私有仓库或需要校验 commit 一致性的场景。它不下载历史，只打包指定 commit 下的指定路径：
git archive --remote=git@github.com:username/repo.git HEAD:path/to/file.txt | tar -xO > file.txt
-
--remote要求服务端启用upload-archive（GitHub/GitLab 默认开启，自建 Git 服务器需确认） - 必须用 SSH URL（
git@...）或带认证的 HTTPS URL；普通 HTTPS URL 通常被拒绝 -
HEAD可替换为具体 commit hash 或分支名，path/to/file.txt是仓库内相对路径，不能以/开头 - 输出是 tar 流，
tar -xO表示解压到 stdout，配合重定向保存为文件
为什么不用 git sparse-checkout？
它看起来像“只检出部分文件”，但实际仍需先 git clone --no-checkout 下载整个 .git 目录（含全部历史对象），只是跳过工作区文件写入。对“节省带宽”“快速获取单个文件”毫无帮助：
- 首次
git clone --filter=blob:none可减少传输量，但仍是全量索引 + 元数据，不是单文件 -
sparse-checkout主要用于大型单体仓库中长期只维护子目录，不是一次性下载方案 - 容易误设导致后续
git pull拉下不该有的文件，尤其在团队协作中易引发混乱
真要最小化传输又需 Git 语义，优先选 git archive --remote；否则，raw URL 最直接。别被“sparse”字面意思带偏——它不省流量，只省磁盘空间（而且只省工作区）。
