Terraform Visual 字段级 Diff 指南：轻松对比变更前后的属性差异
【免费下载链接】terraform-visualTerraform Visual is an interactive way of visualizing your Terraform plan项目地址: https://gitcode.com/gh_mirrors/te/terraform-visual
Terraform Visual 是一款简单却强大的Terraform plan 可视化工具，它能把你晦涩难懂的 Terraform 执行计划转换成直观的交互式图表。而本文要重点讲解的Terraform Visual 字段级 Diff，则是它最实用的能力之一：不用再对着终端里密密麻麻的~和+符号发愁，只需鼠标悬停，就能清晰对比每个资源属性在变更前后的具体差异。
为什么你需要字段级 Diff？
日常使用 Terraform 时，terraform plan输出的 diff 信息往往很长：几百个资源的变更挤在一起，很难快速定位「到底改了什么」。字段级 Diff 的意义在于，它把关注点从「整个资源」下沉到「单个属性」，让你一眼看清某个字段从什么值变成了什么值。
举个典型场景：你只是把 S3 桶的acl从private改成public-read，传统方式需要在海量输出里翻找；而使用 Terraform Visual，直接悬停对应资源节点，右侧面板立刻展示acl字段的 before / after 对比，变更一目了然。
最快配置方法：三步生成 JSON 格式的 Plan
要使用字段级 Diff，第一步是把 Terraform plan 转换成 JSON 格式。在项目根目录执行两条命令即可：
$ terraform plan -out=plan.out # 生成 plan 文件 $ terraform show -json plan.out > plan.json # 导出为 JSON 格式生成的plan.json就是可视化分析的数据源，其中每个资源的change.before和change.after分别记录了变更前后的属性快照，这正是字段级 Diff 的核心依据。
字段级 Diff 的核心原理：before 与 after 对比
Terraform Visual 在内部会将before与after中同名属性提取出来，逐字段做对比。观察源码 utils.ts 中的getDiff方法可以看到：
- 先遍历
change.before，收集变更前的属性值； - 再检查
change.after_unknown，若字段在 apply 后才能确定，则标记为(known after apply)； - 最后遍历
change.after，收集变更后的属性值。
最终的展示效果是并排对比：左侧绿色/红色显示变更前值，中间用箭头衔接，右侧显示变更后值（见 focused-view.tsx）。属性值若是 JSON 对象还会自动美化缩进，复杂嵌套结构也能轻松阅读。
一张表看懂 5 种操作类型的颜色标识
字段级 Diff 用颜色区分操作类型，视觉上非常直观：
| 操作类型 | 颜色 | 含义 |
|---|---|---|
| Create | 🟢 绿色 | 新增资源，所有字段均为新值 |
| Update | 🟡 黄色 | 修改属性，字段值发生变化 |
| Delete | 🔴 红色 | 删除资源，所有字段均为旧值 |
| Create-Delete | 🟢→🔴 | 先重建再删除（替换） |
| Delete-Create | 🔴→🟢 | 先删除再重建（替换） |
颜色样式定义在 focused-view.module.css 中，逻辑则在getFieldChangeColorClassName函数里统一处理，方便后续自定义主题。
快速上手：用 CLI 生成字段级 Diff 报告
如果你不想把 plan 上传到公网，推荐使用官方 CLI 工具在本地生成报告：
# 安装 CLI $ npm install -g @terraform-visual/cli # 生成可视化报告 $ terraform-visual --plan plan.json # 打开报告 $ open terraform-visual-report/index.html生成的terraform-visual-report/index.html是纯静态页面，完全离线可用，也可以直接放进 CI/CD 流水线或团队文档中。CLI 的核心实现非常精简，见 cli/src/index.ts：读取 plan JSON 后将其注入模板页面并输出报告目录。
写在最后
Terraform Visual 的字段级 Diff 把「变更审查」这件事变得前所未有的轻松——既可以在线版上传 JSON 即用，也可以用 CLI 在本地生成报告，还能接入 CI/CD。无论你是刚接触 IaC 的新手，还是每天要 review 大量变更的资深工程师，它都能帮你更快、更准地对比属性差异，避免因漏看某个字段而导致的线上事故。
如果你也想体验，clone 仓库后按上面的步骤跑一遍，几分钟就能生成属于你的第一份可视化 Terraform plan 报告。
【免费下载链接】terraform-visualTerraform Visual is an interactive way of visualizing your Terraform plan项目地址: https://gitcode.com/gh_mirrors/te/terraform-visual
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
