PhpStorm 不运行 Composer 而是调用本地可执行文件，配置失败主因是路径错误、vendor 被排除或缺失 autoload.php；必须填绝对路径并验证，确保 autoload.php 存在且可读。
PhpStorm 本身不运行 Composer，它只调用你本地已安装的可执行文件；配置失败，90% 是因为路径填错、vendor 目录被排除，或项目压根没生成 autoload.php。
Composer executable path 必须填绝对路径，不能写 composer 或 which composer
PhpStorm 不走 shell 环境变量，也不解析 alias。填 composer 看似省事，实际会直接报 “Command not found”。
- macOS/Linux 正确示例：
/usr/local/bin/composer（Homebrew 安装）或/opt/homebrew/bin/composer（Apple Silicon） - Windows 正确示例：
C:\ProgramData\ComposerSetup\bin\composer.bat（注意是 .bat，不是 .phar） - 若用项目级
composer.phar，必须填完整绝对路径，如：/path/to/my-project/composer.phar - 填完后务必点 Validate；失败就检查该路径下是否存在可执行文件、是否有执行权限
vendor 目录标红、类名不补全？先确认 vendor/autoload.php 是否真实存在且可读
PhpStorm 不靠“猜”，它只信任 vendor/autoload.php 这个入口文件来建立符号索引。没有它，整个 vendor 就是黑盒。
- 运行
composer install或composer dump-autoload后，检查vendor/autoload.php文件是否生成、大小非零 - 右键
vendor/→ Mark Directory as → 确保没选 Excluded（选了等于告诉 PhpStorm：“别管这个目录”） - 如果刚装完依赖但补全仍不生效，手动触发：
File → Reload project from Disk或点右上角刷新图标 - 某些旧版 PhpStorm 对
composer.lock中的platform配置（如ext-gd）感知弱，可能导致 autoload 解析跳过部分包
PhpStorm 内置 Terminal 找不到 composer 命令？它默认不继承你的 shell PATH
图形界面里配置对了，终端里却提示 command not found——这是 macOS/Linux 下最常被忽略的环境隔离问题。
立即学习“PHP免费学习笔记（深入）”；
- 打开
Settings → Tools → Terminal，把 Shell path 改成你日常用的 shell，比如：/bin/zsh或/bin/bash - 别用空值或默认的
cmd.exe（Windows 除外），否则 PATH 不加载 - 验证系统级安装：
which composer（macOS/Linux）或where composer（Windows），路径应与 PhpStorm 中填的一致 - Homebrew 用户注意：PHP 和 Composer 可能分装在不同 bin 目录，
/opt/homebrew/bin/composer未必在/usr/local/bin下，必要时加软链：sudo ln -s /opt/homebrew/bin/composer /usr/local/bin/composer
点 “Install” 卡住或报 “Could not find package”？优先弃用图形按钮，改用终端手动执行
PhpStorm 的图形化 Add Dependency 底层强制加 --no-interaction 和固定版本约束，网络超时、镜像失效、版本冲突时几乎必挂，还看不到具体错误。
- 国内用户务必提前配镜像源：
composer config -g repo.packagist composer https://packagist.phpcomposer.com - 手动执行更可控：
composer require monolog/monolog:^3.0，实时看到 Connection refused、Version not found 等真实原因 - 如果
composer.json有语法错误（如末尾多逗号、单引号闭合不全），PhpStorm 会静默忽略整个文件——用composer validate先校验 - 添加新 PSR-4 映射后，记得补一句：
composer dump-autoload，否则 PhpStorm 无法识别你新增的命名空间
最易被忽略的其实是 vendor/autoload.php 的存在性与可读性——它不是“有 composer.json 就自动有”，也不是“点一下 Install 就生成”。所有代码提示、跳转、依赖树，都卡在这个文件上。路径对、目录没被 exclude、autoload.php 存在且内容有效，三者缺一不可。
