SonarLint在PhpStorm中默认不生效主因是静默禁用、语言模式错误或分析引擎未就位：需启用“Enable SonarLint”、手动切换右下角状态栏为PHP模式、确保项目绑定SonarQube并启用sonar-php-plugin以激活关键规则。
SonarLint 在 PhpStorm 中默认不生效，不是插件没装好，而是它被静默禁用了，或者语言模式/分析引擎根本没就位。
为什么打开 PHP 文件没波浪线？先查这三个开关
装完插件后打开 .php 文件一片安静，大概率卡在这三处：
-
sonarlint.enabled是 false —— 进 Settings → Editor → Inspections → SonarLint，确认勾选“Enable SonarLint”； - 右下角状态栏显示的是
Plain Text或PHP (Legacy)，点击它，手动切换成PHP（注意：不是“PHP Language Injection”，也不是“PHP Script”）； - 项目根目录的
.idea/settings.json或全局phpstorm64.exe.vmoptions里写了"sonarlint.enabled": false，删掉或改成true。
PHP 规则为什么比 Java 少？这不是配置问题，是能力边界
SonarLint 对 PHP 的分析深度天然受限于其 PHP 分析器（基于 PHP Parser + 自研语义层），不像 Java 那样能跑完整数据流分析。这意味着：
-
array_key_exists($k, $arr) && $arr[$k]这类空键访问不会标红，除非你连上 SonarQube 并启用php:S5786（需sonar-php-plugin支持）； - 未关闭资源（如
fopen()后没fclose()）在本地模式下基本不报，得走 Connected Mode； - 若用 Laravel 或 Symfony，自定义注解（如
@var、@return）没被识别，要确保 PhpStorm 的PHP Language Level设为 8.0+，且启用了PHP stubs（Settings → Languages & Frameworks → PHP）。
想让规则真正起作用，必须配 Connected Mode
本地规则集（SonarSource 默认）对 PHP 覆盖很弱，关键安全与健壮性规则（如 SQL 注入、XSS、类型不安全调用）只在连接 SonarQube 后激活：
立即学习“PHP免费学习笔记（深入）”；
- Settings → Tools → SonarLint → Configure server connection → Add Server，填
serverUrl（如http://localhost:9000）和token（在 SonarQube → My Account → Security → Generate Tokens）； - 绑定项目：点 “Bind project”，选中对应
projectKey（比如my-app-php），确保该 key 在 SonarQube 后台已存在且绑定了sonar-php-plugin； - 别漏掉 PHP 特定参数：在 SonarQube 的项目设置 → Analysis Scope → Settings，确认
sonar.php.file.suffixes包含.php,.phtml,.php3，否则.phtml文件不会扫。
误报太多？关单条规则，别关整个插件
直接设 sonarlint.enabled 为 false 是最省事也最没用的办法。精准控制才是关键：
- 把光标停在告警行，按
Alt+Enter（macOS 是⌥⏎），选 “Change severity for …”，可临时降级为 Warning / Info； - 进 Settings → Editor → Inspections → SonarLint → Rules，搜规则 ID（如
php:S1192表示字符串字面量重复），取消勾选即可全局禁用； - 如果只想在某个目录禁用（比如
vendor/），右键该文件夹 → SonarLint → Exclude from analysis。
PHP 的规则激活严重依赖 SonarQube 后端插件版本和项目绑定状态，本地开箱即用的“检测力”只是冰山一角；没连服务端就指望它揪出 SQLi，等于让自行车去跑 F1 赛道。
