PHP匿名函数不能直接使用标准PHPDoc注释，因解析器会报错；推荐在赋值前用@var标注callable签名，如/@var callable(int, string): bool $validator/，确保PHPStan等工具能正确类型校验。
PHP匿名函数能用PHPDoc注释吗
不能直接在 function() 前写标准 PHPDoc（如 /** @param int $x */），PHP 解析器会报错：「Parse error: syntax error, unexpected '/'」。PHPDoc 是为具名函数、类、方法设计的语法糖，匿名函数没有声明位置可挂载文档块。
实际可用的三种注释方式
虽然不能用标准 PHPDoc，但有明确、合法、被 IDE 和静态分析工具（如 PHPStan、Psalm）识别的方式：
- 在赋值前加普通多行注释（
/* ... */），并把类型提示写进注释内容 —— PHPStorm 和 PHPStan 都支持这种「伪 PHPDoc」解析 - 使用
@var注解标注变量类型，配合匿名函数签名，是最推荐的写法 - 在函数体内用
//或/* */注释逻辑，但不描述接口契约
/* @var callable(int, string): bool $validator */
$validator = function (int $id, string $name): bool {
return $id > 0 && !empty($name);
};注意：@var 必须写在变量赋值语句的正上方，且类型签名要与实际参数/返回值严格一致，否则 PHPStan 会报 TypeMismatch 错误。
为什么不能把 PHPDoc 放在 function() 后面
像这样写是无效的：
立即学习“PHP免费学习笔记（深入）”；
$fn = /** @param int $x */ function (int $x) { ... };原因有二：
- PHP 8.0+ 虽支持「尾随属性」（trailing attributes），但
/** */不是属性，只是注释 token，解析器不会把它和匿名函数绑定 - 即使 IDE 显示了参数提示，PHPStan / Psalm 也完全忽略这类写法，无法做类型校验
更隐蔽的问题是：如果匿名函数被传入高阶函数（如 array_filter($arr, $fn)），缺少 @var 标注会导致后续调用处类型推导失败，静态分析直接放弃检查。
IDE 和静态分析工具的实际识别差异
不同工具对注释的容忍度不同，容易踩坑：
- PHPStorm：能从
@var callable(...): T推导出参数名、类型、返回值，并支持跳转和补全；但若写成@var Closure就失去所有细节 - PHPStan：要求
@var中的签名必须完整，省略任意参数类型（如写callable($x): bool）会被当作mixed处理 - Psalm：接受
@psalm-var更严格的写法，例如@psalm-var callable(int $id, string $name): bool，支持命名参数提示
最稳妥的做法是统一用 @var callable(类型 参数名, ...): 返回类型，避免依赖工具特有语法。
