Terraform vs CloudFormation：IaC 架构圖怎么做
围绕 Terraform and CloudFormation Diagrams 的长尾技术文章，包含示例输入、可视化检查点、常见问题和发布到文档的建议。
为什么这个场景值得单独做成工具
很多开发者已经有 Postman、HAR、TypeScript、Zod、CloudFormation 或 C4 文本，但这些内容通常只适合机器或作者本人阅读。把它们转成图，可以让接口评审、架构讨论和故障复盘更直观。
这篇文章围绕 Terraform vs CloudFormation architecture diagrams 展开，重点不是重新发明格式，而是把已有源码变成可以检查、导出和长期维护的文档资产。
示例输入
建议先使用一个最小可运行片段，而不是一开始就粘贴完整生产文件。小输入能更快暴露解析问题，也能让图表结构更清楚。
例如 API 调试类工具可以从一个请求集合或 HAR 片段开始；Schema 类工具可以从一个 interface 或 z.object 开始；架构类工具可以从两三个资源和关系开始。
预览时应该检查什么
第一，看节点命名是否短而准确。第二，看关系方向是否符合真实调用、依赖或资源引用。第三，看错误分支、外部系统、数据库和队列是否遗漏。
如果图表太大，优先拆成多个局部图：接口请求链路、数据结构、部署拓扑、监控和告警可以分别维护。
常见问题
最常见的问题是把太多上下文塞进一个图里。图表不是知识库全文，它应该回答一个明确问题：谁调用谁、哪个字段属于哪个类型、哪个资源依赖哪个资源。
另一个问题是只导出图片不保留源文件。推荐同时保存源文本和 SVG/PNG，这样后续变更能走代码评审。
发布建议
README、博客和内部文档通常优先使用 SVG；聊天工具和演示文稿可以使用 PNG。对于可编辑或可导入格式，建议把源文件放在 docs 或 architecture 目录下。
如果输入来自 AI，先把它当成草稿。通过预览检查语法、关系和命名，再导出用于正式文档的图片。