PHP 8.5 管道操作符（|>）支持从左到右链式调用单参数 callable，替代嵌套函数提升可读性，需 PhpStorm 2026.2 并设语言级别为 PHP 8.5 才能正确高亮、补全和语义分析。
PHP 8.5 管道运算符 |> 不高亮、不补全、报错
PhpStorm 2026.2 原生支持 |>，但前提是项目语言级别设为 PHP 8.5。不是装个插件就能用，而是 IDE 内核级识别——低版本（如 2025.3）虽也支持，但需手动开启语言级别且不带完整语义分析。
- 进
Settings > Languages & Frameworks > PHP，把PHP language level明确设为8.5（不能选Project default或留空） - 检查
composer.json中"php": "^8.5"是否存在，否则 PhpStorm 可能降级推导类型 - 若仍报
Expected callable, got string类错误，说明右侧表达式未被识别为可调用，常见于未声明返回类型的闭包或动态方法调用
#[FileReference] 注解无法导航到文件
这是 PhpStorm 2026.2 新增的原生特性，不是第三方插件提供，也不依赖任何扩展。它只在函数/方法参数上加了 #[FileReference] 属性时生效，且路径必须是字面量或含 __DIR__ 的拼接。
- 确保使用的是
PhpStorm 2026.2（2026.1 及更早不支持） - 写法必须严格：例如
function loadConfig(#[FileReference] string $path): array，$path传入__DIR__ . '/config.php'才可 Ctrl+Click 跳转 - 变量拼接（如
$base . '/config.php'）或常量（如CONFIG_PATH）不会触发导航，这是设计限制，不是 bug
PHP Annotations 插件对 #[NoDiscard] 无提示
#[NoDiscard] 是 PHP 8.5 原生命名属性，由 PhpStorm 内置解析器处理，和 PHP Annotations 插件无关。后者只管 Doctrine/Symfony 风格的 @ 注解，不处理 #[]。
- 确认
PHP language level已设为8.5，否则#[NoDiscard]会被当作文本标记，不参与语义检查 - 启用
Settings > Editor > Inspections > PHP > PHP language level migration aids，它会标出被忽略的#[NoDiscard]返回值 - 不要往
PHP Annotations > Namespaces里加#[NoDiscard]—— 它不是命名空间类，加了也没用
泛型嵌套类型（如 Collection<user></user>）提示不准
PhpStorm 2025.3 起支持嵌套泛型，但依赖 PHPDoc 注释质量。它不读运行时反射，只靠 @var、@param 和框架约定（如 Laravel 的 Collection 自动推导）。
立即学习“PHP免费学习笔记（深入）”；
- 优先用 PHP 8.5 原生类型语法：
function getUsers(): Collection<user></user>，比@return Collection|User[]更可靠 - 若用 PHPDoc，确保
@template和@extends配对正确，比如class UserCollection extends Collection<user></user> - 禁用
PHP Annotations对泛型的干扰：该插件默认不处理@template，但若误配了命名空间，可能污染索引
|>），有些靠注解插件（如 @ORM），还有些只在特定上下文生效（如 #[FileReference] 仅限参数）。混用旧插件或错配语言级别，第一反应往往是“插件没装好”，其实只是底层机制没对齐。 
