能否扩展Terraform的variables.tf文件？模块变量复用咨询

问题场景 #

在Terraform模块嵌套使用时，常遇到变量重复定义的痛点：

• 定义S3桶模块的variables.tf时，声明了bucket_name变量
• 当CloudFront分发模块引用这个S3桶模块时，必须在自身variables.tf中重复定义bucket_name，再新增distribution_name这类专属变量
• 若后续还有us-east-1地域模块、staging/prod环境模块层层嵌套，每一层都要重复所有前置模块的变量，新增变量时还要逐个更新多个variables.tf文件

希望实现类似import_variables的语法，直接导入子模块的变量并扩展，请问这个思路是否可行？有没有现成的实现方法？

可行方案与思路分析 #

1. 采用模块输出传递值（Terraform推荐最佳实践） #

不要在父模块中重复定义子模块的变量，而是让子模块输出必要的值，父模块直接引用这些输出，彻底避免变量透传：

• 在S3桶模块的outputs.tf中添加输出：

output "bucket_name" {
  type        = string
  description = "Name of the S3 bucket"
  value       = aws_s3_bucket.this.bucket
}

output "bucket_regional_domain_name" {
  type        = string
  description = "Regional domain name of the S3 bucket"
  value       = aws_s3_bucket.this.bucket_regional_domain_name
}

• CloudFront模块无需定义bucket_name变量，直接通过模块引用获取值：

module "s3_bucket" {
  source = "./modules/s3_bucket"
  bucket_name = var.bucket_name # 仅在顶层/父模块定义一次该变量，传递给子模块
}

resource "aws_cloudfront_distribution" "this" {
  origin {
    domain_name = module.s3_bucket.bucket_regional_domain_name
    origin_id   = module.s3_bucket.bucket_name
  }
  # 其他CloudFront配置...
}

2. 用根模块变量统一管理公共参数 #

如果多个模块共享环境名、地域这类公共变量，可在根模块的variables.tf中统一定义，再通过参数传递给各个子模块，避免每个模块重复声明：

• 根模块variables.tf定义：

variable "environment" {
  type        = string
  description = "Deployment environment (staging/prod)"
}

variable "region" {
  type        = string
  description = "AWS deployment region"
}

• 子模块引用时直接传递：

module "s3_bucket" {
  source = "./modules/s3_bucket"
  bucket_name = "${var.environment}-static-assets-bucket"
  region      = var.region
}

module "cloudfront" {
  source = "./modules/cloudfront"
  distribution_name = "${var.environment}-cdn-distribution"
  origin_domain     = module.s3_bucket.bucket_regional_domain_name
}

3. 关于import_variables类语法的可行性 #

Terraform目前没有原生支持直接导入其他模块变量定义的语法——这是因为模块设计的核心是封装性：每个模块应仅暴露自身需要的输入变量，避免依赖外部模块的变量结构，防止子模块变更导致父模块出现意外故障。

如果强行通过脚本等外部工具合并variables.tf文件，虽能实现类似效果，但会破坏模块封装性，大幅增加维护复杂度，不推荐这种做法。

内容的提问来源于stack exchange，提问作者Gergő Horváth