Terraform多模块场景下如何共用单个变量文件？

这个问题我之前也碰到过，本质是Terraform的工作目录上下文限制导致的——当你在子目录运行terraform validate时，它只会扫描当前目录的.tf文件，完全不会向上查找父目录的变量定义，所以才会报“变量未声明”的错误。这里有几个实用的解决方案，按推荐程度排序：

1. 始终在根目录执行Terraform命令（最直接） #

这是最简单也最符合Terraform工作流的方式。你的根目录是整个配置的核心，variables.tf在这里定义后，所有子目录的资源配置都会被纳入根目录的工作区上下文。在根目录运行：

terraform validate

Terraform会自动扫描所有子目录下的配置文件，识别根目录定义的变量，完美解决报错问题。

2. 在子目录用-chdir切换到根目录执行验证 #

如果你不想切换到根目录，也可以在子目录直接通过-chdir参数指定根目录为工作区，执行验证命令：

terraform -chdir=.. validate

这个命令的效果和你在根目录运行terraform validate完全一样，既不用切换目录，也能让Terraform加载全局变量定义。

3. 将子目录配置为Terraform模块（最佳实践） #

你的目录结构其实非常适合用Terraform模块来组织，这也是官方推荐的配置方式。把alb/、networking/、servers/都做成独立模块，根目录作为主模块来引用它们并传递变量：

步骤示例： #

1. 在根目录创建main.tf，引用各个子模块并传递根目录的变量：

module "alb" {
  source = "./alb"
  # 传递根目录定义的变量给alb模块
  vpc_id = var.vpc_id
  subnet_ids = var.subnet_ids
}

module "networking" {
  source = "./networking"
  vpc_cidr = var.vpc_cidr
}

module "servers" {
  source = "./servers"
  instance_count = var.instance_count
  ami_id = var.ami_id
}

2. 在每个子模块目录下，只需要定义自己需要的输入变量（比如alb/variables.tf）：

variable "vpc_id" {
  type = string
  description = "VPC ID for the ALB"
}

variable "subnet_ids" {
  type = list(string)
  description = "Subnets to attach the ALB"
}

这样做的好处是：

• 配置结构更清晰，每个模块职责单一
• 在根目录运行terraform validate会自动验证所有模块的变量传递是否正确
• 模块可以单独复用在其他项目中

虽然需要给每个模块定义输入变量，但这是Terraform模块化的标准流程，能大幅提升配置的可维护性。

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