VSCode 的 Terraform 插件仅提供语法高亮、补全和校验，不执行 init/plan；需手动配置任务或终端命令，且依赖本地 terraform CLI 可用及正确的工作区结构。
VSCode 的 Terraform 插件本身不执行 terraform init 或 plan，它只提供语法高亮、补全和简单校验；真正让 IaC 工作流跑起来，得靠手动配置任务或集成终端命令。
安装插件后为什么 main.tf 还是没高亮？
常见原因是 VSCode 没把文件关联到 Terraform 语言模式。Terraform 官方插件（HashiCorp Terraform）默认只识别 .tf 和 .tfvars 后缀，但不会自动识别 main.tf 文件名——它依赖文件扩展名，而非内容。
- 右键编辑器标签页 → “Change Language Mode” → 选
Terraform - 或按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Change Language Mode，回车后选Terraform - 想永久生效？在用户设置里加：
"files.associations": {"*.tf": "terraform"}
terraform fmt 在保存时自动触发不了？
插件默认关闭保存时格式化，且依赖本地已安装的 terraform CLI 可执行文件在 $PATH 中。即使装了插件，which terraform 在终端返回空，格式化就静默失败。
- 确认 CLI 可用：在 VSCode 内置终端运行
terraform version，必须有输出 - 打开设置（
Ctrl+,），搜terraform.formatOnSave，勾选启用 - 如果用的是非标准路径（比如
/opt/terraform/1.6.0/terraform），需在设置中显式指定："terraform.path": "/opt/terraform/1.6.0/terraform" - 注意：格式化仅作用于当前打开的
.tf文件，不会递归处理整个模块目录
变量补全失效，var. 后没提示？
这是插件最常被误判“不好用”的点——它只对已声明的 variable 块生效，且要求变量定义和引用在**同一工作区根目录下**。跨模块（module "xxx"）或远程模块（source = "git::..."）的变量不会被索引。
- 检查
variables.tf是否存在且语法正确（比如漏了type或description不影响补全，但漏了variable "name" { }外层块会彻底失效） - 确保
variables.tf和引用它的main.tf在同一个 VSCode 工作区文件夹内（不是子文件夹单独打开） - 插件不解析
tfvars文件内容，所以var.env能补全，但var.env实际值是否合法，得等terraform validate或plan阶段才报错
真正卡住人的往往不是插件功能，而是 CLI 环境和工作区结构——比如在 WSL 中用 VSCode Desktop 打开 Windows 路径，terraform 命令却只装在 WSL 里，此时插件找不到二进制文件，所有依赖 CLI 的功能（格式化、验证、文档悬停）全部静默降级。先跑通 terraform version，再谈补全和高亮。
