必须启用Database Tools and SQL插件，该插件默认捆绑但可能被禁用；未启用时Database工具窗口（Alt+1）不显示、SQL无高亮补全、查询控制台不可用；启用后无需重启，但已开SQL文件需重新打开。
Database Tools and SQL 插件必须启用
PhpStorm 默认已捆绑并启用 Database Tools and SQL 插件，但若数据库工具窗口不出现、SQL 语句无高亮/补全/执行按钮，第一反应不是重装，而是确认该插件是否被意外禁用。
检查路径：Ctrl+Alt+S → Plugins → 切换到 Installed 选项卡 → 搜索 Database Tools and SQL → 确保复选框已勾选。未启用时，所有数据库连接、SQL 编辑器、查询控制台功能均不可用，且不会报错提示。
- 禁用后即使配置了数据库连接，
Database工具窗口（默认快捷键Alt+1）也不会显示 - 插件启用后无需重启 IDE，但已打开的 SQL 文件需重新打开才能触发语法识别
- 该插件与
PHP Annotations、Laravel Idea等插件无依赖冲突，可共存
SQL 字符串注入失败的常见原因
在 PHP 文件中写 "SELECT * FROM users" 却没有语法高亮或关键字提示？不是插件问题，是 IDE 不知道这段字符串是 SQL —— 它默认当作纯文本处理。
正确做法：将光标置于双引号或单引号内（例如 "S 上），按 Alt+Enter（macOS 是 Option+Enter），选择 Inject language or reference → SQL。成功后右下角状态栏会显示 SQL 小标签。
立即学习“PHP免费学习笔记（深入）”；
- 拼接字符串无效：
"SELECT * FROM " . $table无法注入，IDE 无法静态推断语义 - 变量插值也不行：
"SELECT * FROM {$table}"同样被判定为非字面量，注入菜单不出现 - 一次注入只作用于当前字符串；批量场景建议改用
query()方法 + 类型注解（见下一条）
PDO/MySQLi 对象调用 query() 无 SQL 提示
写了 $pdo->query("SE") 却没自动补全？根本原因是 $pdo 被 IDE 识别为 mixed，而不是 PDO 实例。
必须让类型信息链完整：
- 确保已配置 PHP 解释器：
Settings → Languages & Frameworks → PHP → CLI Interpreter不能为None - 在声明处加 PHPDoc：
/** @var \PDO $pdo */，或直接赋值$pdo = new PDO(...) - 若用封装类（如
DB::connection()），需在方法上标注@return \PDO，否则返回值类型丢失 - 检查
vendor是否标记为Sources：右键vendor→Mark as → Sources，否则 PDO 的 stubs 不加载，query()方法签名不可见
SQL 高亮颜色不对或关键字不生效
很多人去 Settings → Editor → Color Scheme → Language Defaults → Keywords 改颜色，结果 SELECT 还是灰色——因为 SQL 的样式完全独立于通用关键词设置。
真正控制 SQL 高亮的位置是：Settings → Editor → Color Scheme → SQL。这里分项管理：
-
Keyword：控制SELECT、WHERE、JOIN等保留字颜色 -
Identifier：影响表名、字段名（如users.id中的users和id） -
String：控制'value'或"value"中引号内内容的样式 -
Comment：管理--和/* */注释的显示
改完记得点 Save As 保存为自定义方案，避免被系统更新覆盖。SQL 样式修改不生效，90% 是因为进错了节点。
