SublimeLinter 调用 php -l 或 pylint 失败的根本原因是 GUI 启动的 Sublime 不继承 shell 的 PATH 环境变量，需手动配置各系统环境路径并开启 debug 模式验证。
SublimeLinter 调不到 php -l 或 pylint，根本不是插件问题
它压根没启动——因为 GUI 启动的 Sublime 不继承 shell 的 PATH，哪怕终端里 php -v 和 pylint --version 都正常，Sublime 里照样静默失败。这不是配置漏了，是进程环境从一开始就不一样。
验证方法：按 Ctrl+` 打开控制台，执行 import os; print(os.environ.get('PATH'))，对比终端输出。常见现象是 macOS 上缺 /opt/homebrew/bin，Windows 上根本找不到 xamppphp 目录，Linux 上没 /usr/bin 以外的路径。
- macOS 用户必须改
~/Library/LaunchAgents/environment.plist并launchctl unload -w ... && launchctl load -w ...，光改~/.zshrc没用 - Windows 用户改完系统环境变量后，要彻底退出所有 Sublime 进程（包括托盘图标），再双击启动
- Linux 用户只保证
~/.profile里设了PATH，~/.bashrc里的设置对 GUI 无效
PHP 语法检查不报错？先确认 SublimeLinter-php 真的调到了 php
SublimeLinter-php 只是封装了 php -l 命令，它不自带 PHP 解释器，也不报错提示“找不到 php”——失败时直接跳过，看起来就像“没反应”。
- 打开
Preferences → Package Settings → SublimeLinter → Settings，在用户配置中加"php_executable": "/opt/homebrew/bin/php"（macOS）或"php_executable": "C:\xampp\php\php.exe"（Windows），路径必须和终端里which php或where php输出一致 - 别写
php纯命令名，也别把php.exe放进 PATH 却不验证 Sublime 是否能读到——GUI 启动下 PATH 是另一套 -
-l模式只检查语法，错误定位靠file_regex提取行号，推荐配"file_regex": "php.*?on line (\d+)"
Python linter（如 pylinit）跳转/提示失效，八成是路径填错了父目录
SublimeLinter-pylint 插件需要找到 pylint 可执行文件，但它要的是**父目录路径**，不是 pylint 文件全路径。填错就永远显示 “No definition found”。
- 终端运行
which pylint，比如输出/Users/alex/.pyenv/shims/pylint，那你要填的是/Users/alex/.pyenv/shims，不是那个完整路径 - Windows 上填
C:UserslexAppDataRoamingPythonPython312Scripts（即where pylint输出去掉文件名后的目录） - macOS 上别填
/usr/bin——那是系统旧 Python，一般没装pylint；用pyenv或homebrew安装的才靠谱 - 确保
pylint是全局可执行的：pylint --version在终端能跑，且不是虚拟环境里临时激活的
调试模式才是唯一可信的诊断手段
所有“为什么没反应”的问题，第一件事就是开 debug。它会把 SublimeLinter 实际做了什么、在哪卡住、路径查到哪一步，全打到控制台里。
- 在
SublimeLinter.sublime-settings（用户）里加"debug": true - 重启 Sublime，按
Ctrl+`看输出：有cannot locate pylint就说明路径错；有linter not enabled就说明插件没启用；有command exited with code 1就说明 CLI 工具本身报错（比如.pylintrc格式错） - 别信“插件已安装”，
debug下能看到它是否真的加载成功、是否被禁用、是否因依赖缺失跳过
最常被忽略的一点：Sublime 的 GUI 进程和终端进程根本不是同一个环境。你改完 PATH、装好工具、配好插件，只要没验证 os.environ['PATH'] 里真有那个路径，或者没开 debug 看它实际调了谁，就永远在猜。
