装了插件仍无实时校验，大概率是Nginx语言服务器（LSP）未启动，需确保右下角语言模式为“Nginx Configuration”、文件后缀匹配或手动设置、插件启用且无冲突，并通过Developer Tools或故意写错语法验证LSP是否运行。
为什么装了插件还是没实时校验
装 raynigon.nginx-extension 后仍无错误提示，大概率是语言服务器（LSP）根本没启动。这个插件依赖后台进程提供校验能力，不是光装上就自动生效——它需要 VSCode 识别出当前文件属于 Nginx 语言模式，且该模式已绑定 LSP。
常见卡点：
- 右下角语言标识显示的是
Conf或Plain Text，不是Nginx Configuration（注意大小写和空格） -
settings.json里写了"*.conf": "nginx"，但实际打开的是default（无后缀）或site-enabled/example（无 .conf） - 插件安装后未重启 VSCode，或工作区禁用了该扩展
如何确认 Nginx 语言服务器正在运行
打开一个真实 Nginx 配置文件（如 /etc/nginx/nginx.conf），按 Ctrl+Shift+P（Mac 为 Cmd+Shift+P），输入 Developer: Toggle Developer Tools，切换到 Console 标签页，搜索 nginx 或 lsp。如果看到类似 [nginx] Starting language server 或 Connection to server got closed，说明 LSP 已尝试启动。
更直接的办法：在配置里故意写错一行，比如 listen 80 少个分号，保存后看左下角状态栏是否出现 ⚠️ 1 problem，鼠标悬停是否提示 Missing semicolon。没有？说明 LSP 没接管。
实操建议：
- 确保文件后缀是
.conf或.nginx；若用无后缀文件（如default），需手动点击右下角语言标识 → 输入Nginx→ 选中Nginx Configuration - 检查插件设置：
nginx.enableLanguageServer必须为true（默认开启，但可能被 workspace 覆盖） - 避免与其他 Nginx 插件共存：
mrmlnc.nginx会冲突并导致 LSP 启动失败
语法实时校验能发现什么，不能发现什么
LSP 做的是静态结构分析，不是真跑 Nginx。它能立刻标出：
- 指令拼写错误，比如把
proxy_pass写成proxypass - 块级结构缺失，比如
server {没有对应} - 变量名未定义，比如用了
$real_ip但没启用realip_module -
include路径不存在（仅当路径是字面量字符串，且插件启用了 file existence check）
但它不会告诉你：
-
nginx -t才能暴露的问题：比如root指向的目录不存在、ssl_certificate文件权限不对、stream块里用了 HTTP 指令 - 变量展开结果是否合法：例如
set $port "8080"; listen $port;在 LSP 里完全合法，但 Nginx 实际加载时会报错 - 模块是否启用：写了
limit_req_zone却没编译--with-http-limit-req-module，LSP 不管
本地调试时怎么配合 nginx -t 自动触发
VSCode 本身不执行 nginx -t，但可通过 Task + keybinding 实现“保存即验证”。关键不是自动化，而是让错误反馈链路变短。
步骤：
- 在项目根目录建
.vscode/tasks.json，内容含一个 task："command": "nginx", "args": ["-t"]，并设"isBackground": true - 给该 task 绑定快捷键，比如
Ctrl+Alt+T（Mac 为Cmd+Alt+T） - 若配置文件不在默认路径，task 中加
-c参数指向你的真实路径，如"-c", "/etc/nginx/nginx.conf" - 别依赖 “保存即运行”：Nginx 配置常涉及多文件
include，单文件保存无法反映全局有效性
真正容易被忽略的是：远程编辑时，nginx -t 必须在目标服务器上运行。SFTP 同步后，得切到 Terminal 手动执行，或配好 sudo 免密再一键触发——VSCode 的 task 默认只在本地执行。
