VSCode 是适配 Terraform 开发的轻量级环境，需安装 HashiCorp 官方扩展、配置 CLI 路径、启用保存时格式化与校验、支持模块跳转，并通过终端执行 plan 与查看 output。
如果您在使用 Terraform 进行基础设施即代码（IaC）开发时，希望获得更高效的编辑体验、语法高亮、智能补全与实时错误检查，则 VSCode 是一个高度适配的轻量级开发环境。以下是将 VSCode 深度集成 Terraform 的关键配置与操作方式：
本文运行环境：MacBook Air M2，macOS Sequoia。
一、安装 Terraform 官方扩展
VSCode 通过扩展机制提供对 Terraform 语言的原生支持，官方扩展由 HashiCorp 维护，可启用 HCL 语法高亮、格式化、文档悬停及资源引用跳转等功能。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X）。
2、在扩展搜索框中输入 Terraform by HashiCorp。
3、在搜索结果中找到发布者为 HashiCorp 的扩展，点击“安装”按钮。
4、安装完成后，重启 VSCode 或重新加载窗口以激活扩展功能。
二、配置 Terraform CLI 路径
VSCode 的 Terraform 扩展需明确识别本地安装的 terraform 可执行文件路径，否则无法执行格式化、验证等 CLI 集成操作。
1、在终端中运行 which terraform，确认其输出路径（如 /usr/local/bin/terraform）。
2、在 VSCode 中按下 Cmd+, 打开设置界面，切换至“工作区”标签页。
3、在搜索框中输入 terraform.path，找到对应设置项。
4、点击编辑图标，在输入框中粘贴上一步获取的完整路径。
三、启用自动格式化与保存时校验
通过配置 VSCode 的格式化行为，可确保每次保存 .tf 文件时自动执行 terraform fmt，并在保存前触发 terraform validate 检查基础语法合法性。
1、在 VSCode 设置中搜索 editor.formatOnSave，勾选启用。
2、搜索 terraform.formatOnSave，确保其值设为 true。
3、打开命令面板（Cmd+Shift+P），输入并选择 Preferences: Configure Language Specific Settings...。
4、选择 Terraform，在弹出的 JSON 编辑器中添加："terraform.validateOnSave": true。
四、使用远程状态与模块导航增强开发效率
当项目采用远程后端（如 S3 + DynamoDB）或大量模块调用时，VSCode 扩展可解析 backend 配置与 module source 地址，支持点击跳转至对应模块定义位置。
1、确保 main.tf 中包含有效的 terraform { backend "s3" { ... } } 块。
2、在任意 module 块中，将光标置于 source = "..." 的字符串值内。
3、按住 Cmd 键并单击该字符串，若路径可解析（本地路径或 Git URL），VSCode 将自动打开对应模块的根目录或 main.tf。
4、若跳转失败，检查 .terraform/modules 目录是否已通过 terraform init 正确填充。
五、调试与输出变量的实时查看
VSCode 不直接运行 terraform apply，但可通过集成终端与任务配置，快速执行 plan 输出并高亮显示 output 变量变更，辅助验证配置意图。
1、在 VSCode 底部点击“终端” → “新建终端”，确保当前工作目录为 Terraform 根模块路径。
2、运行 terraform plan -out=tfplan 生成执行计划文件。
3、运行 terraform show -json tfplan | jq '.resource_changes[] | select(.change.actions[] == "create")' 查看将创建的资源列表。
4、在输出中定位 outputs 字段，其值将随 plan 结果动态计算并显示。
