如何为Git克隆仓库设置默认配置？全局配置被覆盖问题排查

问题描述 #

已全局设置git config --global core.filemode false，但克隆GitHub上的空仓库后，本地仓库的.git/config里却自动生成了core.filemode = true，未遵循全局配置。实际操作步骤如下：

$ git config --global core.filemode
false
$ git clone https://Me@<Repository>.git
Cloning into '<Repository>'...
Password for 'https://Me@github.com': 
warning: You appear to have cloned an empty repository.
$ head -n 3 <Repository>/.git/config 
[core]
    repositoryformatversion = 0
    filemode = true
$ 

原因分析 #

这不是GitHub导致的，是Git自身的初始化行为：

1. 克隆空仓库时，Git在本地执行git init逻辑（远程仓库无内容，本地需要初始化完整仓库结构）
2. git init命令默认会在本地.git/config中写入core.filemode = true，这是Git内置的本地默认值，而Git配置优先级为：本地仓库配置 > 全局配置 > 系统配置
3. 只有当本地配置不存在该选项时，才会读取全局配置的值；一旦本地配置明确写入，就会直接覆盖全局设置

解决办法 #

1. 克隆后手动修正本地配置 #

针对已克隆的仓库，直接执行本地配置命令覆盖：

git config core.filemode false

2. 修改Git初始化模板，批量解决新仓库问题 #

如果需要所有新初始化/克隆的空仓库都继承全局的filemode设置，可修改Git的初始化模板：

• 先查看Git模板目录路径：

  git config --get init.templateDir
  

  若返回空，默认路径为：Linux/macOS是/usr/share/git-core/templates，Windows是Git安装目录\mingw64\share\git-core\templates
• 打开模板目录下的config文件，添加以下内容：

  [core]
      filemode = false
  

  之后所有新git init或克隆空仓库的操作，都会自动使用这个模板配置，不再写入默认的true

3. 避免克隆空仓库（可选） #

如果仓库中已有至少一个文件，克隆时Git不会在本地配置中主动写入core.filemode，此时会自动读取全局配置的false值。可以先在本地初始化仓库、添加文件后再推送到GitHub，后续克隆就不会出现这个问题。

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