必须安装hashicorp官方插件并配置terraform.path绝对路径，启用language server且验证启动成功；非标准.tf文件需手动关联语言模式，否则格式化、补全、跳转等功能全部失效。
装完 HashiCorp 官方 Terraform 插件，不等于能用——90% 的人卡在 terraform.path 配错或 Language Server 没真正跑起来上。
怎么确认装的是正确的 Terraform 插件
VSCode 扩展市场搜 “Terraform”，只认发布者是 HashiCorp 的那个。名字叫 “Terraform” 但发布者是 “Terraform”、“HCL” 或其他第三方的，一律卸载。
- 错误现象：
resource "aws_后无补全、点provider "aws"跳不到定义、状态栏显示Plain Text或HCL (unofficial) - 第三方插件只做基础语法高亮，不支持
terraform fmt、go to definition、内联 provider 文档等关键能力 - 安装后必须点 “重新加载窗口”，否则语言服务器不会初始化
为什么 terraform.path 必须配绝对路径
插件本身不带 terraform 二进制，所有 CLI 功能（fmt、validate、init）都靠调用你本地装好的命令。配错就全挂。
- 终端执行
which terraform（macOS/Linux）或where terraform（Windows），复制完整路径，例如/usr/local/bin/terraform或C:\Program Files\Terraform\terraform.exe - VSCode 设置里搜
terraform.path，在“工作区”设置中粘贴该路径——别只写terraform，除非你确定 PATH 已全局生效且插件能继承 - 常见坑：
which terraform返回的是 WSL 路径，但 VSCode 在 Windows 下启动；macOS 上用tfenv管理多版本，which返回的不是你当前项目想用的那个
Language Server 没启动的典型表现和验证方法
即使插件装了、路径对了，LSP（Language Server Protocol）也可能静默失败：没 hover 提示、变量跳转失效、module source 路径悬停空白、实时诊断不标红线。
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入并运行Terraform: Restart Language Server - 打开底部面板 → “输出” → 下拉选
Terraform，看日志里有没有Server started successfully - 如果报端口冲突（如
address already in use），说明有旧进程残留或另一个插件占用了 LSP 默认端口 - 确保项目根目录有
terraform { required_version = ">= 1.0" }块，且已执行过terraform init（生成.terraform/目录）
非标准文件名（如 .infra.tf）怎么启用 Terraform 功能
VSCode 默认只识别 .tf 和 .tf.json，其他后缀如 .infra.tf、.backend.tf 都得手动绑定语言模式，否则插件功能全部降级为纯文本。
- 打开一个
main.infra.tf文件，点击右下角语言标识（比如显示Plain Text） - 选 “配置文件关联…” → 输入
*.infra.tf→ 回车 → 从列表选Terraform - 这个设置会写入
.vscode/settings.json的files.associations，无需重启，但建议关掉再重开文件验证 - 多个自定义后缀要逐个配，
*.backend.tf、*.vars.tf都一样处理
最常被忽略的一点：terraform init 不只是为执行 plan 做准备，它生成的 .terraform/ 目录是语言服务器读取 provider schema 和模块结构的唯一来源——没它，补全和跳转就是摆设。
