tflint

TFLint Terraform 静态检查

补充说明

TFLint 检查 Terraform 的语法、废弃用法、Provider 规则和云厂商最佳实践。它补充 terraform validate 无法发现的深层问题。

支持 AWS、Azure、GCP 等插件，可自定义规则。

常用示例

安装：

brew install tflint
tflint --version

初始化插件：

tflint --init

扫描：

tflint
tflint --recursive
tflint --format json > tflint.json

启用云厂商规则：

cat > .tflint.hcl <<'EOF'
plugin "aws" {
  enabled = true
  version = "0.35.0"
  source  = "github.com/terraform-linters/tflint-ruleset-aws"
}
EOF
tflint --init

易错点与排错

• 没有执行 tflint --init，插件未安装，规则不生效。
• 插件版本与 Terraform 版本不兼容。
• 只扫描根模块，漏掉子模块和环境目录。
• 规则太严格，大量历史代码无法通过，先做基线。
• 与 terraform fmt/validate 职责混淆，三者都要跑。
• CI 缓存丢失，每次重新下载插件。
• 自定义规则写错，误报或漏报。