PHPStorm 不内置 Composer 配置，仅调用本地 composer 命令；需手动设置可执行路径、通过命令行配置镜像、标记 vendor 为代码源并重载项目以实现依赖识别与自动补全。
PHPStorm 本身不配置 Composer，它只调用你本地的 composer 命令；所谓“集成”，本质是让 IDE 正确找到、触发并感知这个命令的行为——镜像、依赖识别、自动补全，全取决于你终端里那套 Composer 配置是否生效。
Composer 可执行路径必须手动填对
PHPStorm 不会自动从 PATH 读取 composer，尤其在 Windows 或 macOS 多 PHP 版本环境下，它常默认指向错误位置（比如系统自带旧版或空路径）。
- 进入 Settings → PHP → Composer，检查
Composer executable字段 - Linux/macOS 常见正确路径：
/usr/local/bin/composer或~/.composer/vendor/bin/composer - Windows 常见路径：
C:ProgramDataComposerSetupincomposer.bat（不是composer.exe） - 如果用的是
composer.phar，路径必须带完整文件名，例如：/opt/myapp/composer.phar - 填完后点右侧
Test按钮，确认能输出Composer version x.x.x，否则右键菜单和图形化操作全部失效
镜像配置只能走命令行，PHPStorm 没有 UI 入口
Settings 里搜 “mirror”、“repository” 或 “source” 都找不到对应选项——这不是功能缺失，而是设计逻辑：镜像属于 Composer 自身配置范畴，IDE 不越权管理。
- 全局镜像（推荐）：在终端运行
composer config -g repo.packagist '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}' - Windows CMD 用户需用双引号并转义内部引号：
composer config -g repo.packagist "{\"type\": \"composer\", \"url\": \"https://mirrors.aliyun.com/composer/\"}" - 键名
repo.packagist是固定写法，拼成repos.packagist或repository.packagist会静默失败 - URL 必须以
https://开头且结尾带/，否则部分 Composer 版本请求直接 404 - PHPStorm 内置 Terminal 执行该命令即可，无需重启 IDE，但要确保终端用户与开发用户一致（别用 root 配，却用普通用户跑项目）
vendor 补全失效？关键不在 Composer，而在 IDE 的索引设置
即使 composer install 成功，new GuzzleHttpClient() 仍标红、无法跳转，大概率是 PhpStorm 没把 vendor 当作代码源，而非镜像或依赖问题。
立即学习“PHP免费学习笔记（深入）”；
- 右键项目根目录下的
vendor文件夹 → Mark Directory as → Not Excluded（不是Excluded！） - 进 Settings → PHP → Composer，勾选
Enable composer.json validation和Synchronize IDE settings with composer.json - 点击
Reload project from composer.json（小刷新图标），强制重建 autoload 映射和符号索引 - 若仍无效，检查
composer.json中autoload是否定义正确，例如"App\": "src/"对应的是项目内src/目录，路径错一个字符就全挂
验证镜像是否真生效，别信 composer config -g 输出
这条命令只告诉你“写了什么”，不告诉你“用了什么”。项目级 repositories、Docker 容器用户、甚至 CI 环境里的 composer create-project，都可能绕过你的全局配置。
- 先清缓存：
composer clear-cache - 触发真实下载：
composer require monolog/monolog -vvv 2>&1 | grep "Downloading" - 看到
Downloading https://mirrors.aliyun.com/composer/packages.json才算落地；若仍是packagist.org，说明被项目composer.json里的repositories覆盖，或当前用户家目录下没写对配置 - 注意：PHPStorm 有时会缓存旧配置，改完全局镜像后，建议关掉 IDE 再重开一次，避免复用旧环境变量
最易被忽略的点是：PHPStorm 不管你配了多少个镜像，它只忠实地转发命令；真正决定走哪条路的，是你终端里那个 composer 进程读到的配置——而这个配置，既可能来自 ~/.composer/config.json，也可能来自项目根目录的 composer.json，还可能被 disable_functions 拦在启动前。
