为何Windows环境下GitLab Runner构建仓库会采用CRLF换行？

为什么Windows下的GitLab Runner构建时会使用CRLF？ #

这是Git在Windows系统中的默认配置core.autocrlf=true导致的。该配置会让Git在克隆仓库时自动将仓库内的LF换行符转换为Windows系统默认的CRLF；提交代码时再把CRLF转回LF。GitLab Runner运行在Windows机器上时，会继承系统的Git全局配置，因此克隆项目时会自动执行这个换行符转换操作。

问题1：如何让GitLab Runner在本地目录克隆项目时保持换行符一致？ #

有三种可行方案，按优先级推荐：

• 项目级配置（推荐）：在项目根目录添加.gitattributes文件，指定全局或特定文件的换行符规则。比如要强制所有文件使用LF：

  * text=auto eol=lf
  

  该文件会被仓库追踪，对所有克隆该项目的环境生效，包括GitLab Runner。
• Runner全局配置：在GitLab Runner所在的Windows机器上，打开命令行执行以下命令修改Git全局配置，关闭自动换行符转换：

  git config --global core.autocrlf false
  

  或者强制全局使用LF：

  git config --global core.eol lf
  

  注意：此配置会影响该Runner上运行的所有项目。
• CI任务临时配置：在.gitlab-ci.yml的before_script中添加Git配置命令，仅对当前CI任务生效：

  before_script:
    - git config core.autocrlf false
  

问题2：远程仓库中的Dockerfile使用LF换行，克隆后被转为CRLF怎么解决？ #

最直接且可靠的方案是通过.gitattributes指定Dockerfile的换行符规则，在项目根目录的.gitattributes中添加：

Dockerfile text eol=lf

这样Git会强制将Dockerfile的换行符设为LF，无论克隆环境是Windows还是其他系统，都不会进行换行符转换。

如果已经修改了Runner的全局Git配置（关闭autocrlf），也能解决此问题，但项目级的.gitattributes配置更灵活，不会影响其他项目。

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