安装hcl语法包后不生效，需手动绑定.tf/.tfvars文件到hashicorp terraform语法；高亮弱则调整主题scope或换用ayu等iac优化主题；补全和lint需配置lsp-terraform及terraform cli；windows路径含空格时须设"shell_cmd": null。
安装 HCL 语法包后仍不生效？检查 Package Control 和文件关联
Sublime 默认不识别 .tf 或 .hcl 后缀，装了插件也不高亮，大概率是文件没绑定到 HCL 语法。先确认是否已通过 Package Control 安装了 HashiCorp Terraform（官方维护）或 HCL（社区常用）插件。装完别急着写代码——打开一个 main.tf，右下角状态栏会显示当前语法（比如 “Plain Text”），点击它，选 Open all with current extension as… → HashiCorp Terraform。这步必须做，否则 Sublime 不知道该用哪个语法解析器。
- 如果状态栏没出现选项，说明插件没装成功，重装
HashiCorp Terraform包（不是Terraform单字包，那个已弃用） -
.tfvars文件需单独绑定：同样点击状态栏 →Open all with current extension as… → HashiCorp Terraform，它默认不自动关联 - 绑定后，重启 Sublime 有时能解决缓存导致的高亮延迟
变量、模块块颜色太淡？调整配色方案或语法作用域
很多主题（比如 Monokai、Adaptive）对 HCL 的 variable、module、output 等块名支持弱，看着像普通文本。这不是插件问题，是主题没定义对应 scope。打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入 Developer: Show Scope Name，把光标放在 resource 上，看到类似 source.hcl meta.block.resource.hcl 的输出。复制 meta.block.resource.hcl，在当前主题的 .sublime-color-scheme 文件里加一条规则（路径通常为 Packages/Theme - Default/Monokai.sublime-color-scheme）：
{
"scope": "meta.block.resource.hcl",
"foreground": "var(--green)"
}
更省事的办法：换用专为 IaC 优化的主题，比如 ayu 或 Material Theme，它们对 source.hcl 的 scope 覆盖更全。
代码补全和 lint 报错不工作？HCL 插件 ≠ LSP 客户端
装了 HashiCorp Terraform 插件只管高亮和基础折叠，不提供 terraform validate 或自动补全。要真·智能提示，得配 LSP：先装 LSP 插件，再装 LSP-terraform（它会自动下载并管理 terraform-ls 语言服务器）。注意两点：
-
LSP-terraform要求本地已安装terraformCLI，且版本 ≥ 1.0；运行terraform -v能输出才有效 - 项目根目录必须有
terraform { required_version = "..." }块，否则terraform-ls可能拒绝启动 - 如果保存后没反应，检查 Sublime 控制台（
Ctrl+`）有没有LSP-terraform: server crashed类错误，常见原因是terraform-ls二进制权限不足（Linux/macOS 需chmod +x）
Windows 下路径含空格导致 lint 失败？绕过 shell 解析
在 Windows 上，若 Terraform 项目路径含空格（如 C:\Users\Alice Wang\infra），LSP-terraform 启动时可能因 shell 解析失败报错 spawn terraform-ls ENOENT。这不是路径错了，是 Sublime 的 LSP 客户端调用方式触发了 cmd 的参数截断。解决方法：在 LSP-terraform 设置里强制指定完整路径，并关闭 shell 模式：
{
"command": ["C:/Users/Alice Wang/.terraform-ls/terraform-ls.exe"],
"shell_cmd": null
}
关键是把 "shell_cmd" 设为 null，让 LSP 直接 exec 而非经 cmd 解析——这个细节连 LSP-terraform 文档都没强调，但实测能解决 90% 的 Windows 路径问题。
高亮只是起点，真正卡住人的永远是那些没报错、但补全不弹、lint 静音、路径带空格就崩的“静默失效”。配完记得开个新窗口，用 terraform init 初始化一次，再打开 main.tf ——这时候才算是活的 HCL 环境。
