phpstorm 不自带 composer，需手动配置绝对路径指向本地 composer 可执行文件，并确保项目含 composer.json 且已运行 composer install 生成非空 vendor/ 目录。
PhpStorm 本身不运行 Composer，它只是调用你本地已安装的 composer 可执行文件来解析依赖、补全类名、识别 vendor/ 中的代码 —— 所以配置失败，90% 是因为没让 PhpStorm 找到正确的 composer 命令，或项目里压根没生成 vendor/。
怎么让 PhpStorm 找到你的 composer
PhpStorm 不自带 Composer，必须指向系统中真实可用的 composer（全局安装的 PHAR、Homebrew 安装的、或 Windows 下的 composer.bat）。
- 打开
Settings / Preferences → Languages & Frameworks → PHP → Composer -
Composer executable path必须填绝对路径，不能写composer或which composer—— 这会导致找不到命令 - 常见正确路径示例：
macOS/Linux：/usr/local/bin/composer或/opt/homebrew/bin/composer
Windows：C:\ProgramData\ComposerSetup\bin\composer.bat（不是.phar文件） - 填完后点
Validate，如果提示 “Command not found”，说明路径错、权限不足，或该路径下实际没有可执行文件
为什么 vendor 目录没被识别、类名不补全
即使 composer 路径对了，PhpStorm 也不会自动扫描 vendor/ —— 它依赖 composer.json 和实际存在的 vendor/autoload.php 来建立符号索引。
- 确保项目根目录下有
composer.json，且已运行过composer install（不是只改了 JSON 就完事） - 检查
vendor/是否存在、是否非空；若为空，PhpStorm 会跳过加载所有第三方类 - 右键点击
vendor/→Mark Directory as → Excluded？千万别选这个 —— 这会让 PhpStorm 彻底忽略整个目录 - 如果刚运行完
composer install，但补全仍不生效，手动触发：菜单File → Reload project from Disk或点击右上角刷新图标
使用自定义 composer.phar 或多版本时怎么切
如果你用 composer2、composer1 别名，或把 composer.phar 放在项目里，PhpStorm 默认不识别这些别名或相对路径。
- 不要填
composer2或./composer.phar—— PhpStorm 不走 shell 环境变量，也不解析当前 Shell 的 alias - 想用项目级 composer：把
composer.phar放进项目根目录，然后填它的绝对路径，例如/path/to/my-project/composer.phar - 想区分 PHP 版本对应的 Composer（如 PHP 8.1 用 Composer 2.5，PHP 7.4 用 Composer 2.2）：为不同项目单独配置不同的
composer路径，而不是全局共用一个 - 注意：某些旧版 PhpStorm（composer.lock 中的平台配置（如
ext-gd）感知弱，可能导致插件兼容性提示误报
真正卡住人的往往不是“怎么配”，而是“以为配好了”——比如 composer 路径验证通过了，但 vendor/ 是空的；或者 vendor/ 有内容，却误标为 Excluded。PhpStorm 的依赖识别是静态扫描 + autoload 规则驱动的，它不会替你执行安装，也不会猜你忘了运行 install。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
