GitHub Action中sed使用变量时找不到已存在文件的解决方法

核心问题分析 #

你遇到的问题本质是shell对环境变量的解析和文件路径匹配问题——虽然变量值看起来正确，但shell传递给sed的参数可能因为未正确引用、路径上下文不对等原因，导致sed找不到文件。

具体解决步骤 #

• 给环境变量加双引号包裹
  直接使用$TF_VAR_FILENAME时，如果变量值包含空格、特殊字符（或者shell意外拆分参数），sed会把变量内容拆成多个参数处理。修改命令为：

  sed -i 's/目标内容/替换内容/' "$TF_VAR_FILENAME"
  

  双引号能确保变量作为一个完整的路径参数传递给sed，避免解析错误。

• 验证环境变量的实际值
  在执行sed前添加调试步骤，确认变量是否正确：

  echo "当前环境变量值：$TF_VAR_FILENAME"
  ls -l "$TF_VAR_FILENAME"
  

  如果输出的变量值带多余引号、空格或换行，说明变量赋值时出了问题，需要检查环境变量的定义（比如GitHub Action中env字段的赋值是否有多余符号）。

• 确认工作目录一致性
  GitHub Action的不同步骤可能在不同工作目录执行，ls能找到文件不代表sed步骤的工作目录相同。添加pwd命令确认当前路径，或者改用绝对路径定义环境变量：

  env:
    TF_VAR_FILENAME: ${{ github.workspace }}/provision-kafka-aws.tf
  

  用github.workspace（GitHub Action提供的当前工作区绝对路径）拼接文件名，确保路径绝对正确。

• 检查shell执行环境
  如果你的步骤指定了非bash的shell（比如sh），某些变量解析规则可能不同。可以在步骤中明确指定shell: bash，确保变量展开符合预期：

  steps:
    - name: Run sed command
      shell: bash
      run: sed -i 's/目标内容/替换内容/' "$TF_VAR_FILENAME"
      env:
        TF_VAR_FILENAME: provision-kafka-aws.tf
  

示例工作流片段 #

jobs:
  fix-file:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Debug info
        run: |
          pwd
          ls -l
          echo "TF_VAR_FILENAME: $TF_VAR_FILENAME"
      - name: Execute sed with env var
        shell: bash
        run: sed -i 's/old-string/new-string/' "$TF_VAR_FILENAME"
        env:
          TF_VAR_FILENAME: provision-kafka-aws.tf

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