Windows下从GitHub拉取代码出现CRLF异常问题求助

核心原因分析 #

尽管你已经统一了core.autocrlf=false和VS Code的CRLF设置，但问题大概率出在仓库中已存在混合换行符的文件，或者某台机器的项目级Git配置被隐式覆盖，也可能是GitHub端的换行转换规则在特定场景下生效。

分步解决步骤 #

1. 统一项目级Git换行配置 #

先排查两台机器的项目本地Git配置，避免用户/系统级配置被项目配置覆盖：

• 在项目根目录执行以下命令，查看当前换行相关配置：

  git config --local --list | grep -E "(crlf|eol)"
  

• 确保两台机器的core.eol统一设置为lf（推荐跨平台通用格式），执行：

  git config --local core.eol lf
  

• 同时关闭Git的换行符安全检查，防止自动转换：

  git config --local core.safecrlf false
  

2. 标准化仓库内所有文件的换行符 #

仓库中已有的混合换行符是根源，需要一次性统一：

• 先暂存当前未提交的修改（避免丢失）：

  git stash
  

• 让Git重新识别并统一所有文件的换行符：

  git rm --cached -r .
  git reset --hard HEAD
  git add .
  git commit -m "Normalize line endings to LF"
  git push origin main
  

• 在另一台机器拉取最新代码后，重复上述重置步骤，确保本地文件换行符统一：

  git pull origin main
  git rm --cached -r .
  git reset --hard HEAD
  

3. 锁定VS Code和项目的换行配置 #

确认工作区和项目级配置的一致性：

• 打开项目的.vscode/settings.json，添加/确保以下配置：

  {
    "files.eol": "\n",
    "files.trimTrailingWhitespace": true
  }
  

• 如果项目有.editorconfig文件，同步以下规则：

  root = true
  
  [*]
  end_of_line = lf
  charset = utf-8
  

4. 检查GitHub仓库的换行设置 #

进入GitHub仓库的Settings -> Code and automation -> General，找到Line endings区域，确保未开启"Enforce automatic line ending conversion"，该选项会强制覆盖本地的换行配置。

5. 验证修复效果 #

修改任意文件后执行git diff，确认不再出现额外的CR字符。若仍有问题，用cat -A 文件名查看文件的换行符（^M代表CR，$代表LF），或者用git diff --no-index --word-diff查看更精细的差异。

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