VSCode 中 Terraform 开发需安装官方扩展、配置 CLI 路径、启用自动格式化与校验、集成 TLS 语言服务器，并推荐使用 Dev Container 实现环境隔离。
如果您在使用 VSCode 编辑 Terraform 代码时遇到语法高亮异常、模块无法跳转、变量未识别或格式化失效等问题，则可能是由于扩展配置缺失或语言服务未正确启用。以下是针对 VSCode 中 Terraform 开发环境的优化实践：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装官方 Terraform 扩展
VSCode 官方市场提供的 HashiCorp 官方扩展是 Terraform 语言支持的基础，它提供语法高亮、智能提示、资源跳转和文档悬停等功能，确保编辑器能准确识别 .tf 和 .tfvars 文件结构。
1、打开 VSCode，点击左侧活动栏中的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 HashiCorp Terraform，确认发布者为 HashiCorp。
3、点击“安装”，安装完成后重启 VSCode。
二、配置 Terraform CLI 路径
VSCode 的 Terraform 扩展依赖本地已安装的 terraform 可执行文件来提供格式化、验证与初始化能力；若路径未指定，将导致格式化失败或命令不可用。
1、在终端中执行 which terraform，记录返回的完整路径（例如 /usr/local/bin/terraform）。
2、打开 VSCode 设置（Cmd+,），切换到“工作区”选项卡。
3、搜索 terraform.path，在输入框中粘贴上一步获取的路径。
三、启用自动格式化与保存时校验
通过配置保存时自动运行 terraform fmt 和 terraform validate，可即时发现语法错误与风格违规，避免将问题带入版本控制。
1、在 VSCode 设置中搜索 editor.formatOnSave，勾选该项。
2、搜索 terraform.formatOnSave，启用该设置。
3、打开命令面板（Cmd+Shift+P），输入并选择 Preferences: Configure Language Specific Settings...，选择 Terraform，添加如下 JSON 片段：
"terraform.validateOnSave": true
四、集成 Terraform Language Server（TLS）
Terraform Language Server 提供更精确的补全、引用查找与诊断功能，相比基础扩展具备更强的语义分析能力，尤其适用于含大量模块与远程状态的复杂项目。
1、在终端中执行 brew install hashicorp/tap/tflint（如未安装 Homebrew，请先安装）。
2、执行 brew install golang，随后运行 go install github.com/hashicorp/terraform-ls/cmd/terraform-ls@latest。
3、在 VSCode 设置中搜索 terraform.languageServerPath，填入 $(go env GOPATH)/bin/terraform-ls。
五、使用 Dev Container 实现环境隔离
通过 Dev Container 在容器内加载一致的 Terraform 版本、插件与 provider 配置，彻底规避本地环境差异导致的 plan 差异或 init 失败问题。
1、在项目根目录创建 .devcontainer/devcontainer.json 文件。
2、在文件中指定基础镜像为 hashicorp/terraform:1.8.5，并挂载 ~/.terraform.d/plugin-cache 以加速 provider 下载。
3、在 VSCode 中按 Cmd+Shift+P，输入并选择 Dev Containers: Reopen in Container。
