Terraform Plan执行时如何通过-var参数正确传递列表类型变量

报错原因 #

你之前直接拼接的命令没有对包含中括号、嵌套双引号的复杂参数做Shell层的边界保护：Shell会优先把中括号、双引号识别为自身语法标识，导致传给Terraform的实际字符串已经不是合法的HCL列表结构，无法完成参数解析。

核心注意事项 #

• 不要把方括号、列表内容暴露在Shell的无引号解析范围内，否则会被Shell做字符通配、截断处理
• 列表值内部的字符串引号必须保留，这是Terraform识别HCL值的必要格式
• CI/CD环境下优先用单引号包裹所有复杂类型参数，减少不同Shell版本的兼容问题

正确传参写法 #

通用兼容写法（优先推荐，适配绝大多数Linux/CI/CD环境） #

将整个变量名=值的组合用单引号包裹，单引号内的所有字符都会被Shell原样传递，不会触发额外的语法解析，Terraform可直接识别内部的HCL格式列表：

terraform plan \
  -var 'subnets=["subnet-0160740dss2324df7e1","subnet-0faa77cc23fs6776"]' \
  -var 'count_webapp=1' \
  -var 'prefix="tktest2"'

这种写法没有额外的转义成本，对不同Shell版本的兼容性最高。

双引号适配写法（特殊Shell场景使用） #

如果环境规则要求必须用双引号包裹参数，需要对值内部的双引号做转义处理，避免Shell提前截断字符串：

terraform plan \
  -var "subnets=[\"subnet-0160740dss2324df7e1\",\"subnet-0faa77cc23fs6776\"]" \
  -var "count_webapp=1" \
  -var "prefix=\"tktest2\""

PowerShell环境写法 #

如果CI节点为Windows系统使用PowerShell执行命令，同样可以用单引号做参数包裹，无需额外转义：

terraform plan `
  -var 'subnets=["subnet-0160740dss2324df7e1","subnet-0faa77cc23fs6776"]' `
  -var 'count_webapp=1' `
  -var 'prefix="tktest2"'

排障小技巧 #

如果传参后仍出现识别错误，可以先单独打印参数内容，确认是否被Shell篡改：

# 执行后输出的字符串和预期完全一致，说明没有被Shell解析篡改
echo 'subnets=["subnet-0160740dss2324df7e1","subnet-0faa77cc23fs6776"]'

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