VSCode真正支持Terraform开发需同时满足三要素：正确配置terraform.path指向本地CLI可执行文件、启用terraform.languageServer.enabled确保LSP正常运行、开启editor.formatOnSave与terraform.formatOnSave并指定editor.defaultFormatter为hashicorp.terraform，缺一不可。
VSCode 要真正支持 Terraform 开发，光装插件远远不够；关键在 CLI 路径、语言服务器、格式化链路三者对齐，否则会卡在“有高亮但无跳转”“保存不格式化”“变量提示失效”等典型故障上。
terraform.path 配置错误导致所有功能降级
插件依赖本地 terraform 二进制执行校验、terraform fmt 和 terraform init，路径错或权限不足时，状态栏常显示 Terraform not found，且 LSP 启动失败。
- 先在终端运行
which terraform，确认输出是绝对路径（如/usr/local/bin/terraform）；若为空，说明未安装或未加入$PATH - VSCode 设置中搜索
terraform.path，粘贴该路径——注意不是目录，必须是可执行文件全路径 - macOS 上若用
tfenv管理多版本，路径应指向tfenv的 shim（如~/.tfenv/bin/terraform），而非某固定版本软链 - Windows 用户需确认路径使用正斜杠或双反斜杠（
C:/Users/xxx/bin/terraform.exe），单反斜杠易被解析为转义符
Language Server（terraform-ls）未启动或端口冲突
没有正常运行的 Language Server，就无法实现跨文件跳转、模块输入自动补全、实时诊断等核心能力。常见现象是右键 resource 无法 Go to Definition，或悬停无文档提示。
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入并执行Terraform: Restart Language Server - 打开 VSCode 底部面板 → “输出” → 从下拉菜单选
Terraform，查看日志是否含Server started successfully - 若报
address already in use，说明端口（默认 5000–5100 范围）被占用，可手动改端口：在settings.json中加"terraform.languageServerPort": 5001 - 禁用所有非官方 HCL/Terraform 插件（如旧版
ms-vscode.hcl），它们会抢占 LSP 启动权
保存时格式化不生效的四个硬条件
editor.formatOnSave 开启只是表象，真正起效需要四者同时满足：插件识别语言模式、格式化器注册成功、CLI 可调用、文件后缀绑定正确。
- 确保文件右下角显示的是
HCL或Terraform，不是Plain Text；若不对，点击语言标识 → “Configure file association for ‘*.tf’” → 选HCL - 在
settings.json中显式指定格式器："[terraform]": { "editor.defaultFormatter": "hashicorp.terraform" } -
terraform fmt必须能从 VSCode 终端直接运行；若报command not found，说明terraform.path未生效或 CLI 权限受限 - 对
.tfvars或自定义后缀（如.infra.tf），需额外配置"files.associations": { "*.infra.tf": "terraform" }
tflint 集成后提示“no rules enabled”
tflint 默认不启用任何规则，即使插件已安装、CLI 可调用，也不会报错或提示，容易误以为集成失败。
- 在项目根目录创建
.tflint.hcl，至少启用一个基础规则组：plugin "aws" { enabled = true } rule "aws_instance_type" { enabled = true } - VSCode 插件
TFLint（作者 Mehrdad K）需在设置中开启tflint.enabled，并指定tflint.path指向二进制位置 - 若用
tfenv，建议用tfenv install tflint安装匹配版本，避免 CLI 版本与插件协议不兼容 - tflint 不检查语法错误，只做规范层校验；语法级报错仍靠 terraform-ls，二者职责不同，不可互相替代
最常被忽略的一点是：VSCode 的工作区设置（.vscode/settings.json）优先级高于用户全局设置，而 Terraform 插件很多行为（如 terraform.path）默认只读取工作区级配置。多人协作时，务必把关键配置写进项目内的 .vscode/settings.json，而不是只改自己电脑的全局设置。
