vscode中nginx语法高亮是第一道防线，需安装hollowtree.nginx-conf插件、重启后手动切语言模式为“nginx”，并精准配置files.associations路径绑定，否则仅显示plain text；它可标红未闭合块和非法嵌套，但不校验指令合法性或模块加载。
VSCode里nginx -t之前先看语法高亮有没有报错
语法高亮插件不是装饰，是第一道防线。它能提前暴露 server { 缺右括号、location /api { 漏分号、if ($request_method != GET) { 里嵌了 proxy_pass 这类 Nginx 明确禁止的写法。但前提是插件真在工作——不是装了就完事。
- 只认
hollowtree.nginx-conf（ID：nginx-conf）：支持stream块、js_import、map等 1.25+ 指令，且会标红未闭合块和非法嵌套 - 别碰
mrmlnc.nginx：VSCode 1.80+ 后频繁崩溃，不解析stream {，折叠直接失效 - 安装后必须 重启 VSCode 或执行
Developer: Reload Window，否则语言服务不加载，高亮和错误提示全无
右下角显示 Plain Text 就等于没生效
VSCode 默认把所有 .conf 当纯文本，哪怕你刚双击打开的是 /etc/nginx/nginx.conf。点击右下角语言标识后，输入的必须是首字母大写的 Nginx ——输 nginx、NGINX、nginx config 都不会出现选项。
- 如果点开没看到
Nginx：插件没激活，重装 + 重启；或扩展被禁用（检查扩展面板里是否打了勾） - 如果点了变灰又回退：只是临时切换，关文件再打开就丢，必须配
files.associations - 精准路径绑定推荐这样写（避免把
redis.conf也染成粉色）："files.associations": { "/etc/nginx/**/*": "nginx", "/usr/local/etc/nginx/**/*": "nginx" }
为什么高亮正常但 nginx -t 报错？常见三类坑
高亮插件只校验语法结构，不验证指令是否存在、模块是否加载、变量是否合法。所以你看到满屏绿色，nginx -t 却可能爆红。
-
add_header写在if块里：高亮不拦，Nginx 运行时报nginx: [emerg] "add_header" directive is not allowed here -
proxy_pass http://backend;但没定义upstream backend { ... }：高亮不报，nginx -t提示unknown group - 文件含 BOM（尤其 Windows 上用记事本另存过）：高亮全失效，
nginx -t也可能报unexpected "}" in /path/to/conf:1—— 实际错在第 0 行的隐藏字节
折叠 server/location 块失败？先关掉 indentation 折叠策略
VSCode 默认用缩进折叠，但 Nginx 的 server 和 location 是语义块，不是靠空格对齐。插件要起作用，编辑器得允许它接管折叠逻辑。
- 检查
settings.json里有没有"editor.foldingStrategy": "indentation"—— 有就删掉，让它走默认的auto - 确认没设
"editor.folding": false，否则折叠按钮直接消失 - 若
map或geo块不折叠：它们没花括号，插件无法自动识别边界，可用#region map $arg_x和#endregion手动包住（需插件 v0.5.0+）
if 块里能用 return 却不能用 proxy_pass；map 块值可以是字符串也可以是变量嵌套。插件再强，也得等你写出它能 parse 的结构。先让 server 和 location 可折叠、可高亮、能标错，就已经挡住 80% 的手抖失误。
