HCL 语法精讲

这一课你将能做到

1. 熟练使用 HCL 的块、参数、引用、字符串插值与条件表达式
2. 用 count 和 for_each 批量生成资源，并说出两者的关键区别
3. 用 lifecycle 规则防止资源被意外替换或销毁

为什么要学

第 1 课的配置只有一个桶，手写没问题。可本站真实部署时，安全组规则可能有十几条、子网要在 3 个可用区各建一个、环境变量要按环境切换——逐条复制粘贴会让配置变成改一处漏三处的维护噩梦。HCL 提供了循环、条件、集合变换等一整套表达式，让你用几十行声明几百个资源。

另外，Terraform 最危险的动作不是新建而是「误删、误替换」：改一个 RDS 的参数，有时意味着删掉旧实例重建，数据全没。lifecycle 就是你给关键资源上的安全锁。这一课解决「写得少」和「删不掉（意外）」两个问题。

先建立图像

HCL 的结构可以类比 Java：

块 block        ≈ 一个带类型的对象声明    resource "aws_s3_bucket" "web" { ... }
参数 argument   ≈ 对象的字段赋值          bucket = "xxx"
表达式 expression ≈ 等号右边的值           var.env == "prod" ? 1 : 0
引用 reference  ≈ 访问另一个对象的字段     aws_s3_bucket.web.id

批量生成的两种心智模型：

count   = 一排编号座位：resource[0]、resource[1]、resource[2]
for_each = 一个 Map 查表：resource["a"]、resource["b"]（键稳定，删中间不挪位）

跟着做

步骤 1：块、参数与引用

新建 hcl-demo/main.tf：

terraform {
  required_providers {
    aws = {
      source  = "hashicorp/aws"
      version = "~> 5.0"
    }
  }
}

provider "aws" {
  region = "ap-northeast-1"
}

resource "aws_s3_bucket" "assets" {
  bucket = "coderoadmap-hcl-demo-2026"
}

resource "aws_s3_bucket_versioning" "assets" {
  bucket = aws_s3_bucket.assets.id   # 引用：表达依赖，必须先有桶
  versioning_configuration {
    status = "Enabled"
  }
}

引用格式永远是 <块类型>.<资源类型>.<名称>.<属性>，如 aws_s3_bucket.assets.id。引用即依赖，Terraform 据此决定创建顺序。

步骤 2：字符串、插值与条件

locals {
  project    = "coderoadmap"
  env        = "dev"
  bucket_name = "${local.project}-${local.env}-assets" # 插值
  is_prod    = local.env == "prod"

  # 条件表达式：条件 ? 真值 : 假值
  instance_count = local.is_prod ? 3 : 1

  # 集合
  azs      = ["ap-northeast-1a", "ap-northeast-1c", "ap-northeast-1d"]
  port_map = { http = 80, https = 443 }
}

locals 块里定义的是「局部值」，相当于代码里的常量/中间变量，用 local.xxx（单数）引用。HCL 字符串支持转义和常见函数：lower("ABC")、format("%s-%d", "web", 1)、join("-", ["a", "b"])。

步骤 3：用 count 批量生成

为本站在 3 个可用区各建一个子网：