应安装官方HashiCorp Terraform插件、配置terraform CLI路径、启用保存时格式化、绑定非标准文件扩展名至Terraform语言模式，并禁用冲突插件以确保语法高亮、补全及格式化正常。

如果您在使用 VSCode 编辑 Terraform 代码时遇到语法高亮异常、自动补全失效或格式化失败等问题，则可能是由于 Terraform 插件配置不当或版本兼容性引发。以下是解决此问题的步骤：

本文运行环境：MacBook Pro，macOS Sequoia。

一、安装并启用官方 HashiCorp Terraform 插件

该插件由 HashiCorp 官方维护，提供语法高亮、智能提示、资源文档内联查看及 HCL2 支持等核心功能，是保障基础设施即代码编写质量的基础依赖。

1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 Ctrl+Shift+X）。

2、在扩展搜索框中输入 HashiCorp Terraform，确认发布者为 HashiCorp。

3、点击“安装”按钮，安装完成后点击“重新加载”以激活插件。

二、配置 Terraform CLI 路径

VSCode 的 Terraform 插件需调用本地 terraform 可执行文件完成校验、格式化与初始化操作；若未正确指定路径，将导致命令执行失败或功能降级。

1、在终端中运行 which terraform，获取 terraform 二进制文件的绝对路径（例如 /usr/local/bin/terraform）。

2、在 VSCode 中按下 Cmd+, 打开设置界面，切换至“工作区”选项卡。

3、在搜索框中输入 terraform.path，找到对应设置项。

4、将上一步获取的路径粘贴至输入框并保存。

三、启用自动格式化与保存时格式化

Terraform 推荐使用 terraform fmt 统一代码风格，插件支持在编辑器内自动触发该命令，确保团队协作中 HCL 代码结构一致。

1、进入 VSCode 设置（Cmd+,），搜索 editor.formatOnSave，勾选启用。

2、搜索 terraform.formatOnSave，确保其值为 true。

3、右键任意 .tf 文件，选择“格式化文档”，验证是否成功应用缩进与换行规则。

四、配置语言关联以支持非标准文件扩展名

部分项目使用 .tf.json 或自定义后缀（如 .infra.tf）存放 Terraform 配置，VSCode 默认不识别，需手动绑定语言模式以启用插件全部功能。

1、打开任意目标文件（如 main.infra.tf），点击右下角当前语言标识（如 Plain Text）。

2、在弹出菜单中选择“配置文件关联…”。

3、在输入框中键入 *.infra.tf，回车后从列表中选择 Terraform。

4、重启 VSCode 确保语言关联生效。

五、禁用冲突插件并验证 LSP 状态

第三方 HCL 插件或旧版 Terraform 扩展可能与官方插件共存并抢占语言服务器端口，造成诊断信息缺失或跳转失效，需主动排查并清理。

1、在扩展面板中搜索 HCL 与 Terraform Language，停用所有非 HashiCorp 发布的同类插件。

2、打开命令面板（Cmd+Shift+P），输入 Terraform: Show Language Server Output 并执行。

3、观察输出面板中是否显示 Connected to language server 及初始化日志。

# vscode  # 绑定  # 化与  # 非标准  # 文件扩展名  # 框中输入  # 文档  # 运行环境  # 推荐使用  # 右键  # terraform  # lsp  # js  # json  # 端口  # macbook  # mac  # ai  # macos  # 配置文件  # cos  # 自定义