安装 HashiCorp 官方 Terraform 扩展并启用 "Terraform: Use Ls" 选项,确保 terraform-ls 和 Terraform CLI 正确安装;配置 "editor.formatOnSave": true 和 "terraform.formatOnSave": true 实现保存时自动格式化;语言服务器提供实时校验与智能补全,结合 terraform validate 和 Checkov 等工具增强静态检查,提升编写效率与准确性。

使用 VS Code 编写 Terraform 时,通过合理配置可以实现代码格式化、静态校验和自动补全,大幅提升编写效率和准确性。关键在于安装合适的扩展并正确设置语言服务器。
Terraform 扩展安装
打开 VS Code 的扩展市场,搜索并安装 HashiCorp 官方提供的 Terraform 扩展。该扩展由 HashiCorp 维护,提供语法高亮、智能提示、格式化和验证功能的基础支持。
确保你已安装 Terraform CLI 并可通过命令行调用(即 terraform 命令可用)。启用语言服务器(LSP)
HashiCorp 提供了 terraform-ls 作为语言服务器,VS Code 扩展默认会尝试使用它来提供高级功能。你无需手动启动,但需要确保:
- terraform-ls 已安装(可通过 Homebrew、Chocolatey 或 GitHub Releases 安装)
- VS Code 设置中启用了 "Terraform: Use Ls" 选项
启用后,你会获得更精准的自动补全、资源参数提示、模块输入建议和实时语法检查。
格式化与保存时自动修复
Terraform 自带 terraform fmt 命令,VS Code 可在保存时自动运行它。
在设置中添加以下配置:
"editor.formatOnSave": true, "terraform.formatOnSave": true
这样每次保存文件时,代码都会被自动格式化为标准风格,保持团队一致性。
静态校验与错误提示
语言服务器会在你编写时实时检测语法错误、未定义变量、无效参数等常见问题。
你也可以通过终端运行 terraform validate 进行项目级校验,或配置 VS Code 任务集成该命令。
结合 Checkov 或 Semgrep 等工具还能实现安全合规性扫描,这些可通过额外扩展或自定义任务集成。
基本上就这些。配置完成后,你在编写 main.tf、variables.tf 等文件时就能享受流畅的开发体验。不复杂但容易忽略的是确保 CLI 和语言服务器版本兼容,建议定期更新。









