VSCode默认不识别nginx.conf高亮，需安装hollowtree.nginx-conf扩展并手动设置语言模式为“Nginx”，再通过settings.json按路径（如"/etc/nginx/*/.conf"）精准关联files.associations。
VSCode 默认不给 nginx.conf 高亮，不是你配错了，是它根本没“认出”这是 Nginx 配置——得靠扩展 + 显式语言绑定，缺一不可。
装哪个扩展才真正可用
必须用 hollowtree.nginx-conf（发布者是 hollowtree），别选 language-nginx（已归档）、nginx-formatter（只格式化，无高亮）或名字带 “Syntax” “Highlighter” 的旧包。这个扩展支持最新 Nginx 指令（如 stream 块、proxy_http_version 1.1），且持续维护。
- 在 VSCode 扩展市场搜
nginx-conf，认准作者名hollowtree - 安装后重启 VSCode（部分版本需手动 Developer: Reload Window）
- 打开一个
default.conf，右下角点语言标识 → 输入Nginx（注意大小写，不是NGINX或nginx config）→ 立刻生效
为什么手动切一次语言后，下次打开又变回 Plain Text
因为插件不会自动记住你对某个文件的偏好，更不会全局把所有 .conf 绑定过去——那是危险操作，会连 redis.conf、logstash.conf 一起错乱高亮。
- 想让特定文件永久识别，必须进
settings.json配files.associations - 全局写
"*.conf": "nginx"是最常见错误，直接废掉其他 conf 类型 - 推荐按路径精确匹配：
"/etc/nginx/**/*.conf"、"sites-enabled/*"、"conf.d/*.conf" - VSCode 1.85+ 支持
**/nginx.conf这种通配，但不支持正则；include /etc/nginx/conf.d/*.conf;中的路径变量不影响高亮，但跳转和符号索引仍不支持
高亮突然失效或折叠错乱怎么办
大概率不是插件坏了，而是文件本身或环境干扰了语法解析。
- 检查文件编码：若开头有 BOM（尤其是 Windows 记事本保存的），VSCode 解析失败 → 右下角点编码 → Save with Encoding → 选
UTF-8（无 BOM） - 确认没有其他扩展冲突：比如同时装了
nginx-config（hengestone）和hollowtree.nginx-conf，禁用其中一个再试 - 企业环境禁用扩展市场？可手动下载
.vsix文件，用命令行安装：code --install-extension nginx-conf-0.5.0.vsix - 某些 Docker Compose 场景里引用的
nginx.conf不会自动触发语言模式，仍需手动点一次右下角切换
真正麻烦的从来不是装插件，而是路径匹配规则写得太宽泛，或者忽略了 BOM 和多扩展共存带来的静默冲突——这些地方一踩就全黑，但排查起来又没报错提示。
