phpstorm 中 ctrl+q（windows/linux）或 f1（macos）可调出 php 内置函数本地文档，但需满足三项前提：php 解释器已配置、语言级别匹配、索引完成；悬停失效需检查“show quick documentation on mouse move”设置、macos 辅助功能冲突及 stub 路径是否指向最新 phpstorm-stubs。
PhpStorm 里按 Ctrl+Q（Windows/Linux）或 F1（macOS）就能直接弹出 PHP 内置函数的文档说明，不用切浏览器、不用查手册——前提是 PHP 解释器已配好、语言级别匹配、索引已完成。
为什么悬停不显示文档？先检查这三件事
鼠标悬停函数名没反应，不是功能坏了，而是触发条件没满足：
- Settings → Editor → General → Other → 勾选
Show quick documentation on mouse move，延迟建议设为300–400ms（太短易误触，太长像卡住） - macOS 用户注意：系统“辅助功能 → 鼠标键”若启用了“悬停点击”，会和 PhpStorm 的悬停逻辑冲突，导致文档窗完全不弹
- 如果只看到
Loading…或空白框，大概率是 stubs 没加载成功。进 Settings → Languages & Frameworks → PHP → Stub Path，确认路径指向的是最新版phpstorm-stubs（别用过时的@1.0分支）
Ctrl+Q 和 Shift+F1 的分工很明确
两者都查文档，但场景和结果完全不同：
-
Ctrl+Q（Windows/Linux）或F1（macOS）：弹出本地缓存的完整文档面板，含函数签名、@param、@return、简要说明，支持滚动、语法高亮、继承链展示——适合快速确认参数顺序或返回类型 -
Shift+F1（全平台通用）：直接打开 php.net 官方页面，比如json_encode会跳转到https://www.php.net/manual/en/function.json-encode.php，适合看用户评论、扩展用例、版本变更细节 - 注意：
Shift+F1要生效，得先在 Settings → Tools → External Documentation 中启用 PHP.net 文档源，且 URL 模板必须是https://www.php.net/manual/en/function.{element.name}.php
跳转到 stub 文件比看悬浮窗更可靠
当 Ctrl+Q 显示内容不全（比如缺 PHP 8.2 新增的 str_starts_with 参数说明），说明当前语言级别不匹配或 stub 缺失。这时直接 Ctrl+Click（macOS 是 Cmd+Click）函数名，跳转到 phpstubs/phptypes/standard.php 等 stub 文件里的声明处——那里有 PhpStorm 自带的完整注释，是 Ctrl+Q 的数据源头。
跳转前务必确认 Settings → Languages & Frameworks → PHP → Language level 已设为项目实际运行的版本（如 PHP 8.2），否则部分新函数根本不会被识别为可跳转目标。
文档不显示的常见诱因：缓存和注释格式
即使设置全对，仍可能白屏或卡在 loading，根源往往在缓存或注释本身：
- 执行
File → Invalidate Caches and Restart → Just Restart，缓存损坏是导致文档解析中断的高频原因 - PHPDoc 注释必须严格用
/** ... */（开头两个星号），写成/* ... */（一个星号）会被 PhpStorm 忽略 - 对于 Composer 包里的类（比如 Laravel 的
Auth::user()），右键项目根目录 →Load Path from composer.json，否则 vendor 里的 docblock 不会被索引
真正麻烦的不是找不到快捷键，而是文档内容本身依赖 stub 加载状态和语言级别——这两项没调对，Ctrl+Q 就只是个摆设。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
