GitLab Pipeline中使用变量传递提交SHA时git log命令失效

问题场景 #

在GitLab流水线的version阶段使用PowerShell执行器时，通过变量传递提交SHA过滤git日志无输出，但硬编码SHA时可正常返回内容。示例流水线代码：

update_changelog:  
  stage: version
  script:
    - $var1 = "44368ac18c6a286cfce9a7f2e246b15ff54b405c"
    - git log --pretty=format:"%s" ${var1}..HEAD
    - git log --pretty=format:"%s" 44368ac18c6a286cfce9a7f2e246b15ff54b405c..HEAD
      
  allow_failure: false

原因分析 #

问题核心在于PowerShell的语法解析逻辑：PowerShell会将${var1}..HEAD中的..识别为范围运算符（用于生成数字序列，如1..5），而非git log命令中指定提交范围的分隔符。这种误解析导致传递给git log的参数不是完整的SHA..HEAD范围，而是拆分后的无效参数，因此git log无法返回预期日志内容。

解决方法 #

方法1：用双引号包裹完整提交范围 #

将${var1}..HEAD用双引号包裹，让PowerShell先展开变量，再将完整字符串作为单个参数传递给git：

update_changelog:  
  stage: version
  script:
    - $var1 = "44368ac18c6a286cfce9a7f2e246b15ff54b405c"
    - git log --pretty=format:"%s" "${var1}..HEAD"

方法2：使用字符串格式化明确生成范围 #

通过PowerShell的字符串格式化语法预先生成完整的提交范围字符串，避免解析歧义：

update_changelog:  
  stage: version
  script:
    - $var1 = "44368ac18c6a286cfce9a7f2e246b15ff54b405c"
    - $commitRange = "{0}..HEAD" -f $var1
    - git log --pretty=format:"%s" $commitRange

方法3：直接使用GitLab CI变量（若适用） #

如果提交SHA来自GitLab内置变量（如CI_COMMIT_SHA），可直接结合引号使用：

update_changelog:  
  stage: version
  script:
    - git log --pretty=format:"%s" "$CI_COMMIT_SHA..HEAD"

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