必须安装hollowtree.nginx-conf扩展并手动设置语言模式为“Nginx”，再在settings.json中精准配置files.associations路径匹配（如"/etc/nginx/*/.conf": "nginx"），缺一不可；全局匹配"*.conf"会导致其他配置文件错乱高亮。
VSCode 默认不识别 nginx.conf，装了插件也不高亮，不是插件失效，而是语言模式根本没绑定——必须手动切一次语言 + 精准配置 files.associations，缺一不可。
为什么装了 hollowtree.nginx-conf 还是 Plain Text
VSCode 不会自动把任何 .conf 文件当 Nginx 配置处理。插件只提供语法规则，不主动“认文件”。你看到的 Plain Text 是默认 fallback，不是报错。
- 右下角点语言标识 → 输入
Nginx（注意首字母大写，不是nginx或NGINX）→ 如果没这个选项，说明插件未激活：按Ctrl+Shift+P输入Developer: Reload Window重载 - 选中后高亮立刻生效，但仅限当前文件；关掉再打开，又退回 Plain Text —— 这是正常行为，不是 bug
- 别点 “Open all with current extension as… → Nginx”：这会全局把所有
.conf强制绑定，redis.conf、logrotate.conf全部错乱着色
该装哪个扩展才真正可用
必须用 hollowtree.nginx-conf（发布者名 hollowtree），其他常见组合都不可靠：
-
language-nginx：已归档，不支持stream块和proxy_http_version 1.1 -
nginx-formatter：只有格式化功能，无高亮、无语法校验 -
mrmlnc.nginx：作者停更多年，VSCode 1.85+ 下折叠错乱 -
nginx-config（hengestone）：部分用户反馈在 1.118 版本中缩进异常
安装后务必重启 VSCode，或至少执行一次 Developer: Reload Window。
怎么让 /etc/nginx/conf.d/*.conf 自动高亮但不误伤其他 conf
全局写 "*.conf": "nginx" 是最常踩的坑，直接废掉 Logstash、Postfix、HAProxy 的配置文件高亮。必须按路径精准匹配：
- 打开设置（
Ctrl+,），搜settings.json，点击「在 settings.json 中编辑」 - 添加如下内容（路径按你实际部署调整，注意斜杠方向和通配符）：
"files.associations": {
"/etc/nginx/**/*.conf": "nginx",
"/usr/local/etc/nginx/**/*.conf": "nginx",
"conf.d/*.conf": "nginx",
"sites-enabled/*": "nginx",
"nginx.conf": "nginx"
}
VSCode 1.85+ 支持 **/nginx.conf 这种写法，但不支持正则；include /etc/nginx/conf.d/*.conf; 中的路径变量不影响高亮，但跳转和符号索引仍不支持。
高亮突然失效或折叠错乱怎么办
大概率不是插件坏了，而是文件本身或环境干扰了语法解析：
- 检查文件编码：若开头有 BOM（尤其是 Windows 记事本保存的），VSCode 解析失败 → 右下角点编码 →
Save with Encoding→ 选UTF-8（无 BOM） - 确认没有扩展冲突：比如同时装了
nginx-config和hollowtree.nginx-conf，禁用其中一个再试 -
$arg_foo、~*还是灰色？这不是配置问题，是插件能力边界：所有主流 Nginx 插件只做静态词法分析，不解析上下文逻辑，location 块里的正则修饰符不会被特殊着色
路径匹配、编码、扩展互斥——这三个点漏掉任意一个，高亮就不可靠。别指望“装完就自动好”，Nginx 配置在 VSCode 里从来不是开箱即用的类型。
