Sublime Text中JS语法检查生效需满足三条件：①Node.js与jshint全局安装且终端可运行jshint --version；②先装SublimeLinter核心再装SublimeLinter-jshint并重启；③配置executable_map指定jshint绝对路径或修正PATH环境变量，否则静默失效。
Sublime Text 要让 JS 语法检查生效，光装插件不够，必须确保 jshint 命令能在终端里直接运行，否则 SublimeLinter-jshint 会静默失败——它根本不会报错，只是不提示任何问题。
Node.js 和 jshint 必须全局安装
SublimeLinter-jshint 不自带 jshint，它只调用系统 PATH 中的 jshint 可执行文件。所以：
- 先确认已安装 Node.js（建议 v14+，
jshint对 Node v20+ 支持稳定） - 在终端/命令提示符中运行
jshint --version，能输出版本号才算成功 - 若报错
'jshint' is not recognized或command not found，说明没装或没进 PATH - 正确安装方式是：在终端执行
npm install -g jshint（Windows 请以管理员身份运行 CMD；macOS/Linux 若提示权限错误，不要用sudo npm install -g，改用 npm 的本地全局路径方案）
SublimeLinter-jshint 插件安装顺序不能颠倒
必须先装 SublimeLinter 核心，再装 SublimeLinter-jshint，否则后者无法注册：
- 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Package Control: Install Package - 先搜
SublimeLinter并安装（它本身不检查代码，只是调度器） - 重启 Sublime Text（部分版本不重启会导致后续插件加载失败）
- 再次调出命令面板，搜
SublimeLinter-jshint安装 - 装完后打开一个
.js文件，把光标停在明显错误行（比如var a = ;），看左侧行号区是否有红点 —— 没有就说明链路断了
常见静默失效原因：PATH 或配置路径不对
即使 jshint 在终端可用，Sublime Text 有时仍找不到它，因为 GUI 应用启动时的环境变量和终端不一致（尤其 macOS 和某些 Linux 桌面环境）：
- 打开
Preferences → Package Settings → SublimeLinter → Settings – User - 添加
"jshint": {"env": {"PATH": "/usr/local/bin:/opt/homebrew/bin"}}（macOS）或"jshint": {"env": {"PATH": "C:\Program Files\nodejs\"}}（Windows，注意双反斜杠） - 或者更稳妥的方式：指定可执行文件绝对路径，例如
"executable": "/usr/local/bin/jshint" - 如果用了自定义
.jshintrc，务必在配置里写全路径："args": ["--config", "/Users/you/project/.jshintrc"]（注意开头的点不能丢）
验证是否真在工作，别信“已安装”假象
很多用户卡在“明明装了却没提示”，本质是没做最小验证：
- 新建一个
test.js，内容只写一行：var x = ; - 保存文件（SublimeLinter 默认只在保存时触发检查）
- 观察行号左侧：红色圆点 = 语法错误，黄色圆点 = 警告（如未使用变量）
- 把光标移到出错行，底部状态栏应显示类似
jshint: Missing semicolon. - 如果什么都没有，立刻回到终端跑
jshint test.js，看是否报错——如果终端也不报，说明jshint本身没生效；如果终端报了但 Sublime 不报，就是环境或配置问题
真正麻烦的从来不是安装步骤，而是 Sublime Text 启动时继承的环境变量和你终端里看到的不一致。别跳过验证环节，也别依赖“安装完成”的视觉反馈。
