vscode 对 cloudformation 模板支持开箱即用但需确认隐性配置：template.yaml 默认启用完整补全，template.json 需手动设语言模式；部署失败多因 aws toolkit 未正确配置 profile；补全缺失常因 schema 缓存滞后，需升级插件并重载 schema。
VSCode 对 CloudFormation 模板的开发支持，核心是「开箱即用但需确认几处隐性配置」——语法高亮、补全、验证都默认启用，但部署和智能提示是否生效，取决于你打开的是 template.yaml 还是 template.json、是否在工作区根目录、以及 AWS Toolkit 是否真正接管了语言服务器。
为什么 template.yaml 有补全，template.json 却没反应
CloudFormation Language Server 默认只对 template.yaml（含 .yml）启用完整功能；template.json 虽然能语法高亮，但资源类型、属性名、Intrinsic Functions（如 !Ref、!GetAtt）的智能补全默认关闭。这不是 bug，是语言服务器的策略限制。
- 临时解决：右键点击
template.json文件 → “Change Language Mode” → 选 “CloudFormation”（手动触发语言模式绑定） - 长期建议：统一用
template.yaml，YAML 格式对嵌套结构、注释、内联函数更友好，且 AWS 官方文档和 CLI 输出默认倾向 YAML - 验证是否生效：输入
Resources:后敲回车，光标下应立刻出现资源类型建议（如AWS::S3::Bucket）；若无，说明语言服务器未加载
右键“Deploy Stack”失败，报错 “No valid AWS credentials found”
这个错误不是凭据本身无效，而是 VSCode 没读到你设的环境变量或配置文件。AWS Toolkit 不会自动继承 shell 中的 AWS_PROFILE 或 AWS_ACCESS_KEY_ID，它走的是自己的一套 credential chain。
- 必须在 VSCode 设置里显式指定 profile：打开 Settings → 搜索 “aws.profile” → 填入你
~/.aws/credentials里定义的 profile 名（如default或dev） - 如果用 SSO 登录，确保已运行
aws sso login --profile dev，且 Toolkit 设置中 profile 名与 SSO 配置名一致 - 不要依赖
export AWS_*=xxx—— VSCode 启动时未加载 shell 环境，这些变量对插件不可见 - 部署前可先在终端运行
aws sts get-caller-identity --profile dev验证凭证可用性，再回到 VSCode 尝试右键部署
补全内容不全，比如缺少新发布的资源类型（如 AWS::Lambda::FunctionUrl）
CloudFormation 补全依赖本地缓存的资源 Schema，而 Schema 更新滞后于 AWS 服务发布。2026 年 6 月新增的 AWS::Lambda::FunctionUrl 在 Toolkit 1.42 版本中才被纳入，旧版插件即使重装也补不出来。
- 检查 Toolkit 版本：VSCode 左下角状态栏点击 AWS 图标 → 查看版本号；低于 1.42 的必须升级
- 强制刷新 Schema：命令面板（Ctrl+Shift+P）→ 输入 “CloudFormation: Reload Schema” → 回车（该操作会重新拉取最新 OpenAPI 定义）
- 补全仍缺失？查看输出面板（Output → 选择 “AWS Toolkit”），搜索 “schema load failed”，常见原因是网络被拦截或本地代理未配置 HTTPS 白名单
- 临时 workaround：复制官方文档中的 JSON/YAML 片段粘贴进模板，Toolkit 会对已有结构做属性级校验，只是初始补全不出现
最常被忽略的是语言模式绑定和 profile 设置——两者不显眼，但缺一不可；一旦配错，VSCode 会安静地退化成普通文本编辑器，连 !Sub 的括号匹配都会失效。
