Ctrl+Q文档简陋因仅依赖PHP stub文件，无示例和用户评论；需配对PHP解释器、设对语言级别，并装Chinese PHP Document插件才能显示中文完整文档。
PhpStorm 里按 Ctrl+Q（Windows/Linux）或 F1（macOS）就能直接弹出函数文档，但默认只显示英文、不带示例、也不含用户评论——这不是“查不到”，而是没配对源或没装补全插件。
为什么 Ctrl+Q 弹出来的内容很简陋？
PhpStorm 的 Quick Documentation 依赖两个底层数据源：一是内置的 PHP stub 文件（含签名和基础注释），二是可选的外部文档映射。stub 文件本身不带中文、不带用法示例、也不含 php.net 上的用户贡献内容。
- 如果你看到的只有
array_merge(array ...$arrays): array这种签名，没参数说明、没返回值解释，大概率是 stub 没索引完，或语言级别低于函数引入版本 - PHP 8.1 新增的
str_contains()在 Language level 设为 PHP 7.4 时，Ctrl+Q可能完全不响应 - 即使函数识别正常，官方文档里的“Changelog”“Notes”“User Contributed Notes”这些关键信息，stub 根本不包含
想看完整 php.net 官方文档，别点 Ctrl+Q，改用 Shift+F1
Shift+F1 是 PhpStorm 原生支持的“跳转到外部文档”快捷键，它会自动拼接 URL 并在浏览器中打开对应函数的 php.net 页面，比如光标停在 json_encode 上按 Shift+F1，实际打开的是 https://www.php.net/manual/en/function.json-encode.php。
- 这个 URL 是动态生成的，大小写、下划线、连字符都自动适配（
mb_strtolower→mb-strtolower） - 无需手动复制粘贴，也不依赖本地网络是否能访问 php.net —— 它就是调用系统默认浏览器发起请求
- 如果打不开，先检查是否被公司代理/防火墙拦截，而不是怀疑快捷键失效
要查中文文档，必须装插件：Chinese PHP Document
官方 php.net 文档没有中文版，所谓“中文文档”都是社区翻译后注入 stub 的结果。目前唯一稳定维护、适配 PhpStorm 2024.3+ 的插件是 Chinese PHP Document。
立即学习“PHP免费学习笔记（深入）”；
- 安装路径：
File → Settings → Plugins → Marketplace，搜Chinese PHP Document，点击 Install，重启 IDE - 安装后
Ctrl+Q弹窗内容立刻变成中文，含函数作用、参数说明、返回值、示例代码、相关常量等 - 注意：该插件不修改 stub 文件，而是运行时注入注释，所以不影响原有类型推导或索引逻辑
- 如果装了但没生效，检查 Keymap 中
Quick Documentation是否被其他插件或自定义快捷键覆盖
查不到函数？先确认 PHP 解释器和语言级别是否匹配
很多“查不到”本质是 PhpStorm 不认识这个函数——不是文档缺失，是解析器压根没加载它的声明。
- 进
File → Settings → Languages & Frameworks → PHP，确认Interpreter指向你项目实际使用的 PHP 可执行文件（如/usr/bin/php8.2），不是空或指向旧版本 -
Language level必须 ≥ 函数引入版本：比如要用match表达式或str_starts_with，就得设成 PHP 8.0 或更高 - 改完设置后，右下角状态栏会出现 “Indexing…”，等它消失再试
Ctrl+Q；若长期卡住，点右侧Reload index手动触发
真正容易被忽略的点是：stub 文件和插件文档是两套机制，Ctrl+Q 显示什么，取决于谁最后“写入”了注释。装了中文插件但语言级别设太低，照样只显示空签名；没装插件却指望 Ctrl+Q 弹出中文，那是在等一个不存在的更新。
