应安装HashiCorp Terraform官方扩展、配置terraform CLI路径、启用本地HCL语言服务器及保存自动格式化、设置用户代码片段；具体包括扩展安装与语言模式识别、CLI路径设置、禁用远程LSP并启用formatOnSave、创建.terraformrc缓存配置、添加aws_s3_bucket等自定义片段。
如果您在使用 VSCode 编写 Terraform 配置文件时遇到语法高亮异常、自动补全失效或格式化不生效等问题，则可能是由于扩展配置缺失或语言模式未正确识别。以下是解决此问题的步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装并启用 Terraform 官方扩展
VSCode 本身不原生支持 Terraform 语言特性，需通过扩展提供语法解析、LSP 支持及格式化能力。Terraform 官方维护的扩展可确保与最新版本 HCL 语法兼容，并集成 HashiCorp 提供的语言服务器。
1、打开 VSCode，点击左侧活动栏中的扩展图标（或按 Cmd+Shift+X）。
2、在搜索框中输入 HashiCorp Terraform，确认发布者为 HashiCorp。
3、点击“安装”，安装完成后点击“重新加载”按钮使扩展生效。
4、新建一个 main.tf 文件，观察右下角状态栏是否显示 Terraform 语言模式；若未显示，点击该区域手动选择。
二、配置本地 terraform CLI 路径
VSCode 的 Terraform 扩展依赖系统中已安装的 terraform 可执行文件来执行验证、格式化和初始化操作。若路径未正确配置，将导致命令执行失败或提示“terraform not found”。
1、在终端中运行 which terraform，记录输出路径（如 /usr/local/bin/terraform）。
2、打开 VSCode 设置（Cmd+,），切换至“工作区”选项卡。
3、在搜索框中输入 terraform.path，找到对应设置项。
4、将步骤 1 中获取的路径粘贴至输入框并保存。
三、启用 HCL 语言服务器并调整格式化行为
Terraform 扩展默认启用 HCL 语言服务器以提供实时诊断与智能提示，但部分用户可能因网络或代理原因无法连接远程 LSP 端点。此时可切换为本地 CLI 驱动的轻量模式，并自定义格式化规则以匹配团队规范。
1、打开 VSCode 设置，搜索 terraform.languageServer.enabled，将其设为 false。
2、搜索 terraform.formatOnSave，勾选该项以启用保存时自动格式化。
3、在工作区根目录创建 .terraformrc 文件，添加内容：plugin_cache_dir = "$HOME/.terraform.d/plugin-cache"。
4、重启 VSCode 并打开任意 .tf 文件，验证保存后是否触发 terraform fmt 自动重排。
四、配置代码片段提升模块编写效率
重复编写 provider 块、resource 模板或变量定义会降低 IaC 开发速度。VSCode 支持自定义用户代码片段，可快速插入标准化结构，同时保留占位符供后续编辑。
1、打开命令面板（Cmd+Shift+P），输入并选择 Preferences: Configure User Snippets。
2、选择 terraform.json（若不存在则新建）。
3、在文件中添加如下片段：
"aws_s3_bucket": { "prefix": "aws_s3", "body": ['resource "aws_s3_bucket" "${1:name}" {', ' bucket = "${2:name}"', ' acl = "${3:private}"', ' tags = {', ' Name = "${4:${1:name}}"', ' }', '}'], "description": "AWS S3 bucket resource" }
4、保存文件，在 .tf 文件中输入 aws_s3 后按 Tab 键，即可展开完整结构并跳转编辑占位符。
