如何在GitLab Pipeline克隆前设置core.symlinks阻止Windows软链接

你遇到的核心问题是：GitLab Runner执行作业时，克隆仓库的动作是在before_script之前完成的，所以你在before_script里设置core.symlinks根本赶不上克隆阶段。下面是两种可行的解决方案：

方案1：修改GitLab Runner全局配置（适用于所有该Runner的项目） #

1. 找到Runner的配置文件config.toml，默认路径为C:\ProgramData\GitLabRunner\config.toml
2. 在[[runners]]区块下添加环境变量配置，让Runner在克隆仓库前就注入Git参数：

   [[runners]]
     name = "Windows Runner"
     url = "https://your-gitlab-instance/"
     token = "your-token"
     executor = "shell"
     environment = ["GIT_CONFIG_PARAMETERS='core.symlinks=true'"]
     # 保留其他原有配置
   

3. 重启GitLab Runner服务使配置生效：

   Restart-Service gitlab-runner
   

方案2：在项目.gitlab-ci.yml中配置（仅适用于当前项目） #

直接在配置文件的variables区块添加Git配置参数，这个变量会在克隆阶段之前被Git读取：

variables:
  GIT_CONFIG_PARAMETERS: 'core.symlinks=true'

# 后续job配置示例
before_script:
  - git config core.symlinks # 可添加此行验证配置是否生效

注意事项 #

• 确认Runner所在Windows机器已开启开发者模式，这是Git在Windows上处理软链接的前提；
• 确保Git版本不低于2.10.0，更早版本可能不支持GIT_CONFIG_PARAMETERS环境变量；
• 可在job中执行git config core.symlinks命令，验证最终配置值是否为true。

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