如何通过AWS CDK v2直接拉取CloudFormation状态至本地？

核心原因 #

CDK默认依赖本地cdk.out里的合成模板，对比本地代码与CloudFormation远程栈的状态。GitLab Runner环境没有这个目录，自然没法展示嵌套栈的diff细节。

无需同步cdk.out的可行方法 #

• 直接在内存中合成模板对比：执行cdk diff --app "npx aws-cdk synth --no-staging"，这个命令会跳过本地cdk.out的生成，直接在内存里合成模板并和CloudFormation的远程状态对比。前提是CI环境已经装好了项目依赖，且IAM角色有cloudformation:DescribeStacks、cloudformation:GetTemplate这些必要权限。
• 手动API对比（繁琐但可控）：用AWS CLI拉取远程栈的模板（aws cloudformation get-template --stack-name <栈名>），再通过cdk synth --stdout输出本地合成的模板，最后用diff工具对比。但嵌套栈需要自己遍历处理，适合有定制需求的场景。

特性请求现状 #

目前AWS CDK的GitHub仓库里，有不少用户提出过「跳过本地合成，直接拉取CloudFormation远程状态做diff」的特性请求，社区一直在讨论，但截至现在这个功能还没正式上线。可以关注仓库里标记为feature request的相关issue跟进进度。

GitLab Runner中显示完整diff的临时方案 #

如果只是想在CI里看到嵌套栈的完整diff，最省事的办法就是在cdk diff前先跑cdk synth生成临时的cdk.out——毕竟部署前本来就需要合成模板，这个步骤不会额外增加太多成本，还能保证diff输出和本地完全一致。

内容的提问来源于stack exchange，提问作者mati kepa