PHPStorm识别不到自定义函数是因为未声明其签名；需创建\_ide\_helper.php文件，用function声明+PHPDoc注释，并右键标记为Plain Text，最后重载项目索引。
PHPStorm 识别不到自定义函数，是因为没告诉它函数存在
PHPStorm 默认只认 PHP 标准库和已加载的 Composer 包里的函数。你写的 my_helper()、format_date() 这类自定义函数，它根本“看不见”，自然没有补全、跳转、类型提示。解决方法不是改配置菜单，而是让 IDE 知道这些函数的签名——最直接有效的方式是写一个 stubs 文件。
用 _ide_helper.php 声明函数签名（推荐）
这是 Laravel 社区常用、PHPStorm 官方也认可的做法：建一个纯 PHP 文件，里面只写函数声明（不实现），PHPStorm 会把它当“接口说明书”来读。
- 在项目根目录或
resources/下新建文件：_ide_helper.php - 用
function关键字声明函数，参数和返回值写清楚，加 PHPDoc 注释提升类型推断精度 - 确保该文件被 PHPStorm 索引：右键文件 → Mark as → Plain Text（⚠️别选 PHP，否则会报错“function redeclared”）
/**
* 格式化日期为中文短格式
* @param string|int $time 时间戳或可解析字符串
* @return string 如 "2024-03-15"
*/
function format_date($time): string {}
/**
- 获取用户头像 URL
- @param int $uid 用户 ID
- @param string $size 尺寸，如 'small'/'large'
- @return string 头像地址
*/
function avatar_url(int $uid, string $size = 'small'): string {}
为什么不用 include 或 require 加载？
有人试过在
index.php或bootstrap.php里include '_ide_helper.php'，结果 PHPStorm 报错“Cannot redeclare function”。这是因为：立即学习“PHP免费学习笔记（深入）”；
- PHPStorm 在索引阶段会执行所有被包含的 PHP 文件（模拟运行），而你的实际代码也会在运行时加载一遍
- 函数被重复声明，PHP 解析失败，索引中断，补全失效
-
Mark as Plain Text是关键：它让 PHPStorm 只做静态分析，不执行，也不报重定义
其他方式对比：stub 目录 vs. External Libraries
还有两种方法，但都不如
_ide_helper.php灵活：-
File → Settings → Languages & Frameworks → PHP → Stub Path：适合全局复用（如公司内部 SDK），但每次改函数都要重启索引，且对单个项目不直观 -
File → Project Structure → Libraries添加外部目录：容易误加进部署包，且路径硬编码，协作时易出错 - 真正要改的是“声明位置”，不是“加载时机”——函数在哪声明，IDE 就在哪读；声明文件本身不能被执行
最常被忽略的一点：改完
_ide_helper.php后，必须手动触发索引更新 —— File → Reload project from Disk，或者等右下角弹出“Indexing…”提示消失。否则补全还是旧的。
