必须安装HashiCorp官方插件并配置terraform.path路径，否则格式化、补全、跳转等功能全部失效；还需启用Language Server并验证其启动成功，非标准.tf文件需手动关联语言模式。
VSCode 装好 Terraform 扩展后，不等于就能用 —— 90% 的人卡在 terraform.path 配置或语言服务器没起来上。
确认安装的是 HashiCorp 官方插件，不是第三方 HCL 插件
VSCode 扩展市场里搜 HashiCorp Terraform，发布者必须是 HashiCorp（不是 “Terraform”、“HCL” 或其他名字）。第三方插件可能提供基础语法高亮，但不支持 terraform fmt、资源跳转、provider 文档内联等关键能力。
常见错误现象：
- 右键点
Format Document没反应，或提示No formatter installed - 输入
resource "aws_后无补全，provider "aws"点不了跳转 - 状态栏显示
Terraform not found
解决办法：
- 卸载所有名称含
HCL、Terraform Language Support、vscode-terraform（非 HashiCorp 发布）的扩展 - 重启 VSCode，再装一次
HashiCorp Terraform，安装完务必点“重新加载”
必须手动配置 terraform.path，否则所有 CLI 功能失效
插件本身不带 terraform 二进制，它只是调用你本地装好的 CLI。如果 VSCode 找不到命令，terraform fmt、terraform validate、格式化保存等功能全部挂掉。
操作步骤：
- 终端运行
which terraform（macOS/Linux）或where terraform（Windows），复制输出的完整路径，例如/usr/local/bin/terraform或C:\Program Files\Terraform\terraform.exe - VSCode 设置中搜索
terraform.path，在“工作区”设置里粘贴该路径（不要只写terraform） - 改完不用重启，但建议打开一个
.tf文件，看右下角是否显示Terraform语言模式，且状态栏出现版本号
容易踩的坑：
- 路径末尾多了一个空格，导致插件静默失败
- 用的是 WSL，但 VSCode 在 Windows 下启动，
which terraform返回的是 WSL 路径，不兼容 - Mac 用户装了多个 Terraform 版本（brew / tfenv / 手动下载），
which返回的不是你实际想用的那个
检查 Language Server 是否真正运行
即使插件装了、路径配了，LSP（Language Server Protocol）也可能因端口冲突或配置错位没启动，结果就是没有实时诊断、无 hover 提示、go to definition 失效。
验证方式：
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入并执行Terraform: Restart Language Server - 打开底部面板 → “输出” → 下拉选
Terraform，日志里应出现Server started successfully - 若看到
listen tcp :5000: bind: address already in use，说明有其他进程占了默认端口；可改配置项terraform.languageServerPort换个值（如5001）
注意：某些公司策略会禁用本地端口监听，此时 LSP 无法启用，只能依赖外部 CLI 命令（如手动跑 terraform validate）。
非标准文件名（如 .infra.tf）需手动绑定语言模式
VSCode 默认只对 *.tf 和 *.tfvars 启用 Terraform 插件功能。如果你项目用了 main.infra.tf 或 backend.azure.tf 这类命名，插件根本不会激活。
快速修复：
- 打开那个文件 → 点右下角语言标识（比如显示
Plain Text）→ 选“配置文件关联…” → 输入*.infra.tf→ 回车 → 选Terraform - 为永久生效，在工作区
.vscode/settings.json中加：
{
"files.associations": {
"*.infra.tf": "terraform",
"*.backend.tf": "terraform"
}
}
改完不用重启，但已打开的同名文件需手动右键 → “重新打开编辑器以…”，再选 Terraform。
最常被忽略的一点：插件能跑起来 ≠ 代码能跑通。Terraform 是声明式语言，语法正确不代表 provider 配置对、密钥有效、网络可达。VSCode 插件只管“写得对不对”，不管“能不能执行”。每次 terraform plan 前，先确保 ~/.terraformrc 或环境变量里的认证凭据已就位 —— 这部分 VSCode 帮不上忙。
