include path是phpstorm用于代码补全、跳转等静态分析的索引路径，不参与php运行；php.ini的include_path则供php解释器运行时加载文件，二者完全独立。
Include Path 是什么，和 php.ini 的 include_path 有什么区别
Include Path 是 PHPStorm 自己用的一套路径索引机制，只影响 IDE 内部的代码补全、跳转、类型推导（比如 require、include、new 某个类时能识别到定义），它**不参与 PHP 运行时解析**。而 php.ini 里的 include_path 是 PHP 解释器运行时加载文件用的，比如 require_once 'vendor/autoload.php' 能否成功，取决于这个配置。两者完全独立，改一个不会影响另一个。
怎么手动添加 Include Path（不是 vendor 自动扫描）
PHPStorm 默认会把项目下 vendor 目录自动加进 Include Path，但如果你有自定义库（比如本地开发的 SDK、私有组件、Swoole IDE Helper），就得手动加：
- 打开
Settings / Preferences → Languages & Frameworks → PHP → Include Path - 点右上角
+，选Directory，然后定位到你的库根目录（比如/path/to/swoole-ide-helper或/home/user/my-sdk/src） - 确认后，该目录下的所有
.php文件会被索引，类名、函数名就能补全了 - 注意：不要加
src子目录本身——除非你确定所有命名空间都从src开始；通常加src的父级更稳妥
为什么加了路径，new MyHelper() 还是标红、无法跳转
常见原因不是路径没加对，而是 PHPStorm 没识别出命名空间映射关系：
- 检查该库是否有
composer.json，且autoload配置正确（比如"psr-4": {"My\Helper\": "src/"}）；没有的话，IDE 很难推断类路径 - 如果库是纯手动组织的（无 composer），在 Include Path 添加后，右键该目录 →
Mark as → Sources Root，强制告诉 IDE 这里是代码起点 - 别忽略大小写：Linux/macOS 下路径区分大小写，
/MyHelper/和/myhelper/是两个路径，IDE 不会自动归一化 - 改完记得点
Apply，再等几秒让索引重建完成（右下角有进度提示）
Include Path 对新项目生效吗？怎么统一配置
默认只对当前项目生效。如果团队多人共用一套基础库，或你想让所有新建项目自动带某些路径，得配“默认新项目设置”：
- 菜单栏 →
File → New Projects Setup → Settings for New Projects - 导航到
Languages & Frameworks → PHP → Include Path - 点
+加入通用路径，比如公司内部 SDK 的绝对路径 - 注意：这种全局配置对已有项目无效，必须单独进每个旧项目重新加
最易被忽略的是路径有效性——比如 WSL 用户填了 /mnt/c/project/sdk，但 PHPStorm 是 Windows 原生启动的，它根本读不到这个路径；必须用 \wsl$Ubuntuhomeusersdk 或配 Remote Interpreter 才行。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
