nginx配置文件默认不折叠指令块，因vscode内置无nginx语言服务，仅按缩进简单折叠；需安装hbenl的nginx configuration插件并设editor.foldingstrategy为auto，且确保语法正确、无bom、语言模式为nginx。
为什么 Nginx 配置文件默认不折叠指令块
VSCode 默认不为 .conf 或 .nginx 文件提供语义级折叠支持——它把 Nginx 配置当作文本（plaintext），只按缩进做简单折叠，而 server、location、upstream 这类块级指令不会被识别为可折叠单元。这不是插件问题，是语言服务缺失：VSCode 内置没有 Nginx 的 foldingProvider。
安装并启用 Nginx Configuration 插件
必须安装支持折叠的第三方语言扩展，目前最稳定的是 Nginx Configuration（作者：hbenl）：
- 在扩展市场搜索
Nginx Configuration，确认发布者为hbenl（非同名低星插件） - 安装后重启 VSCode，或手动重载窗口（
Developer: Reload Window） - 打开任意
.conf文件，右下角语言模式应自动变为nginx；若仍显示Plain Text，点击右下角手动选为nginx - 此时
server { ... }、location /api { ... }等块左侧会出现折叠控件
折叠失效时优先检查这三项
即使装了插件，折叠图标仍灰色或快捷键无响应，大概率卡在这几个环节：
-
editor.folding被设为false：打开settings.json，确认没有"editor.folding": false这行（工作区设置也可能覆盖） -
editor.foldingStrategy被强制设为"indentation"：Nginx 插件依赖"auto"模式才能解析指令块结构；设为indentation会退化回纯缩进折叠，丢失语义 - 配置语法错误：Nginx 插件需正确解析块嵌套，若漏写
;、错配{/}，或使用了未声明的指令（如proxy_set_header但没加载模块），折叠提供者会直接放弃处理
手动标记复杂嵌套块（如 map / geo 指令）
Nginx 插件对标准块（server/location）支持良好，但对 map、geo、types 等非花括号结构的指令块，可能无法自动识别折叠边界。这时可用编辑器级区域标记：
- 在
map块上方插入独占一行的#region map $http_host（注意：Nginx 注释用#，不是//） - 在块下方插入
#endregion（同样独占一行、无空格） - 保存后，该区域即可折叠；嵌套多个
#region也有效 - ⚠️ 注意：部分旧版 Nginx 插件不识别
#region，建议更新到 v0.5.0+ 版本
真正麻烦的不是装插件，而是 Nginx 配置本身没有统一语法规范——if 块内不能嵌套 proxy_pass，map 块不强制大括号，这些都会让折叠逻辑反复试探失败。别指望一键全折，先让 server 和 location 可折叠，就已经解决 80% 的视觉干扰。
