PhpStorm 自带 Composer 支持但需正确配置路径，否则依赖补全、更新、脚本执行等功能全部失效；必须验证 composer --version 成功，启用 composer.json 自动加载并标记 vendor 为 Sources Root，运行脚本时注意工作目录与 PHP 环境匹配。
PhpStorm 自带对 Composer 的支持，不需要额外安装插件，但必须正确配置 composer.phar 路径或系统级 composer 命令，否则所有功能（如依赖补全、自动更新、脚本执行）都会失效。
确认本地已安装 Composer 并可命令行调用
PhpStorm 不会帮你装 Composer，它只调用你系统里已有的可执行文件。常见失败原因就是 PhpStorm 找不到 composer。
- 在终端运行
which composer（macOS/Linux）或where composer（Windows），确认返回有效路径，例如/usr/local/bin/composer或C:\ProgramData\ComposerSetup\bin\composer.bat - 如果提示“command not found”，说明 Composer 未正确加入 PATH，此时不要在 PhpStorm 里填下载的
composer.phar绝对路径来凑合——它可能因权限或 PHP 版本不匹配而静默失败 - 推荐使用官方安装方式：通过
curl -sS https://getcomposer.org/installer | php下载后，再用sudo mv composer.phar /usr/local/bin/composer（macOS/Linux）设为全局命令
在 PhpStorm 中设置 Composer 可执行文件路径
路径配置错一个字符，PhpStorm 就会退化成纯编辑器，失去所有 Composer 智能支持。
- 打开 Settings / Preferences → Languages & Frameworks → PHP → Composer
-
Composer executable选项必须选中Path to composer.phar或Command line interpreter，取决于你用的是 phar 包还是全局命令 - 若用全局命令，直接填
composer（不是完整路径，除非 PATH 不生效）；若用 phar，必须填绝对路径，例如/opt/composer/composer.phar，且该文件需有可执行权限（chmod +x） - 点旁边的
Validate按钮——它会实际运行composer --version。只有显示版本号才算通过，否则下方会报红字错误，比如Could not open input file: .../composer.phar
启用 composer.json 自动识别与依赖索引
即使 Composer 路径正确，PhpStorm 默认也不会主动扫描 composer.json，需要手动触发或开启监听。
立即学习“PHP免费学习笔记（深入）”；
- 打开项目根目录下的
composer.json，右上角会出现黄色横幅提示Load dependencies from composer.json，点击它，PhpStorm 会解析并索引所有已安装包的类和函数 - 如没出现横幅，手动执行：File → Reload project from composer.json（注意不是 “Reload from disk”）
- 确保
vendor/autoload.php已被标记为 “Sources Root”（右键目录 → Mark Directory as → Sources Root），否则代码补全无法识别第三方类 - 如果修改了
composer.json后依赖没更新，别只点 PhpStorm 的 “Update dependencies” 按钮——它只是调用composer update，仍需你确认终端是否真正完成安装（有时卡在 GitHub token 或网络超时）
运行 composer scripts 和调试常见报错
PhpStorm 的 “Run Configuration” 支持直接运行 composer test、composer serve 等自定义脚本，但环境变量和工作目录容易出错。
- 新建 Run Configuration：点击右上角下拉菜单 → Edit Configurations → + → Composer
-
Script字段填脚本名（如test），不是完整命令；Working directory必须设为项目根目录（含composer.json），否则脚本里的相对路径会崩 - 常见报错：
Script "xxx" is not defined—— 检查composer.json的"scripts"字段拼写，注意 key 是字符串，不是数组索引 - 若脚本依赖特定 PHP 版本（如 Laravel Sail 或 Docker），PhpStorm 默认用系统 PHP 运行，需在配置里指定
PHP interpreter为容器内路径或通过docker-compose exec包装命令
{
"scripts": {
"test": "phpunit --colors=always",
"serve": "php -S localhost:8000 -t public"
}
}
最关键的细节是：PhpStorm 的 Composer 集成高度依赖你本地环境的稳定性。它不会告诉你 composer install 因缺少 ext-zip 而失败，只会显示 “Process finished with exit code 1”——得看终端输出才能定位。所以永远保留一个终端窗口跑 composer install -vvv 备查。
