必须安装HashiCorp官方插件、配置绝对路径的terraform.path、重启VSCode启用语言服务器、手动关联非标准.tf文件后缀，否则格式化、补全、跳转等功能全部失效。
VSCode 里装了 Terraform 插件 ≠ 能用 —— 90% 的问题都出在 terraform.path 配错、terraform-ls 没真正跑起来、或文件后缀没绑定语言模式这三处。
怎么确认 terraform.path 配对了
插件所有 CLI 功能（terraform init、terraform fmt、terraform plan）都依赖这个路径调起本地二进制。配错就是“灰色按钮 + 点击无反应”或终端报 command not found: terraform。
- 先在终端运行
which terraform（macOS/Linux）或where terraform（Windows），复制完整输出，例如/opt/homebrew/bin/terraform或C:/Program Files/Terraform/terraform.exe - VSCode 设置中搜
terraform.path，粘贴**绝对路径**（不是目录，必须带/bin/terraform或.exe） - 路径含空格或中文会静默失败；用
tfenv的用户，应指向~/.tfenv/bin/terraform这类 shim，而非~/.tfenv/versions/1.6.6/bin/terraform - 配完别忘了重启 VSCode 窗口，否则设置不生效
为什么 module 跳转失效、悬停没文档
这不是插件没装好，是 terraform-ls（Terraform Language Server）根本没启动成功。它负责跨文件跳转、模块输入提示、实时诊断，纯靠插件静态分析做不到。
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），运行Terraform: Restart Language Server - 打开底部面板 → “输出” → 切换到
Terraform标签，看有没有Server started successfully - 若报
address already in use，说明端口冲突（默认 5000–5100），可在settings.json中加"terraform.languageServerPort": 5001 - 禁用所有非官方 HCL 插件（如
ms-vscode.hcl），它们会抢 LSP 启动权
保存时格式化不生效的硬条件
editor.formatOnSave 开了只是第一步，真正起效要四者同时满足：语言模式识别正确、格式化器注册成功、CLI 可调用、文件后缀绑定到位。
- 确保
editor.formatOnSave和terraform.formatOnSave都为true - 右键任意
.tf文件 → “格式化文档”，看是否触发terraform fmt -write=true .；失败就说明terraform.path或权限有问题 - 非标准后缀（如
.backend.tf、.infra.tf）必须手动绑定：打开该文件 → 右下角点击语言模式（如显示Plain Text）→ 选Configure File Association for '.infra.tf'...→ 设为Terraform - 检查
editor.defaultFormatter是否设为hashicorp.terraform，否则可能被其他 formatter 拦截
所谓“本地模拟运行”其实是误导
VSCode 插件从不执行 Terraform，它只转发命令给本地 CLI。点 Terraform: Plan 就是在集成终端跑 terraform plan -out=tfplan，和你在 iTerm 里敲一模一样。
- 没有内置 runtime，不管理
terraform.tfstate，也不绕过 provider RPC —— 即使是null_resource，也要走 provider 握手流程 - 想快速验证语法和流程？改用
localbackend +nullprovider：在terraform { backend "local" { path = "terraform.tfstate" } }和provider "null"下写测试资源，再手动terraform init && plan - 悬停看到的
aws_instanceschema 是静态分析结果，不代表能真创建；能否成功，取决于 CLI 执行时 provider 初始化、认证、网络连通性等真实环节
最容易被忽略的是：插件功能强弱完全由你本地 CLI 和 terraform-ls 的状态决定，编辑器本身不参与执行逻辑。任何“点了没反应”“提示不对”“跳转失败”，优先查这两项，而不是重装插件。
