git config --global init.defaultBranch 仅设置 git init 默认分支名，与 clone 深度无关；Git 不支持全局 clone --depth 配置，必须显式传参；可用 shell 别名或 CI 脚本固定浅克隆参数。
git config --global init.defaultBranch 是分支名，不是深度
很多人误以为 init.defaultBranch 能控制克隆深度，其实它只影响 git init 创建新仓库时的默认分支名（比如设为 main），和 git clone 的浅克隆行为完全无关。改这个配置对 --depth 没有任何作用。
Git 本身不支持全局设置 clone --depth 默认值
Git 没有类似 clone.defaultDepth 这样的内置配置项。所有涉及历史截断的参数（如 --depth、--shallow-since、--filter）都必须显式传给 git clone 命令，无法通过 git config 预设。
- 尝试
git config --global clone.depth 1不会生效，Git 会静默忽略该配置 -
git clone的选项解析逻辑不读取任何以clone.开头的配置项 - 即使写入
.gitconfig，也不会改变命令行行为
替代方案：用 shell 别名模拟“默认浅克隆”
虽然不能真正设默认值，但可以通过 shell 别名快速复用常用参数：
- 在
~/.bashrc或~/.zshrc中添加：alias git-clone-shallow='git clone --depth 1 --single-branch'
- 使用时：
git-clone-shallow -b main https://github.com/user/repo.git - 注意：别名不能覆盖原命令（如直接写
git clone），否则会破坏原有语义和脚本兼容性 - 如果项目需子模块，得额外加
--recurse-submodules，别名里不建议硬编码，保持灵活性
CI/CD 环境中更可靠的做法是固定命令模板
在 GitHub Actions、GitLab CI 等场景下，不要依赖用户本地配置，而应在脚本中明确写出浅克隆参数：
- 错误写法：
git clone $REPO_URL（可能拉全量，超时或磁盘爆满） - 推荐写法：
git clone --depth 1 --branch $TARGET_BRANCH --single-branch $REPO_URL -
--single-branch很关键：避免下载其他分支的 ref 数据，进一步减少元数据体积 - 若后续需要切换分支，仍得按需
git config remote.origin.fetch "+refs/heads/*:refs/remotes/origin/*"+git fetch origin $BRANCH --depth 1，这不是配置能绕过的
真正的“默认深度”不存在；所有浅克隆行为都必须由使用者在每次调用时确认并声明，这是 Git 设计上对数据完整性与操作意图的强制约束——省略即代表你要全部。
