PhpStorm中依赖“装了却用不了”主因是Composer与IDE对接失败：需手动配置正确composer路径、标记src为Sources Root、更新JSON Schema、执行dump-autoload并Reload项目。

PhpStorm 里依赖包“明明装了却用不了”，八成不是代码问题，而是 Composer 和 IDE 的对接断在了某个环节——路径、配置、缓存或权限，一个没对上就白装。

Composer CLI 路径填错是头号原因

PhpStorm 不会自动从系统 PATH 找 composer，尤其在 macOS（Homebrew 安装）、Windows（Scoop 或 WSL）环境下，它常去 /usr/bin/composer 或 C:Program Files... 这类不存在的位置硬找。

• 先在终端执行 which composer（macOS/Linux）或 where composer（Windows CMD），拿到真实路径
• 打开 Settings > PHP > Composer，把 Composer executable 改成你查到的绝对路径，比如 /usr/local/bin/composer 或 C:Users amescoopshimscomposer.bat
• 点旁边的 Validate 按钮——失败就说明路径不对，或文件没执行权限（Linux/macOS 可补 chmod +x /path/to/composer）
• 别信 “Auto-detect”：它只扫当前 Project 根目录，不递归，也不识别子项目里的 composer.json

vendor/autoload.php 没被正确引入

依赖装进 vendor/ 后，PHP 运行时根本不知道该去哪找类。PhpStorm 本身不执行 autoload，它只是靠解析 vendor/autoload.php 来提供跳转和补全。

• 确认项目入口脚本（如 index.php）第一行写了 require __DIR__ . '/vendor/autoload.php';
• 检查 vendor/ 目录是否存在且非空；如果用 Git Bash 或 WSL 执行过 composer install，Windows 下可能因权限导致 vendor/ 里文件不可读——换 PowerShell 或 CMD 重装一次
• Linux/macOS 上若报 failed to open stream: Permission denied，执行 chmod -R 755 vendor
• PhpStorm 有时不会自动识别新生成的 autoload 映射，右键项目根目录 → Reload project 强制刷新索引

composer.json 字段标红或补全失效

不是语法错了，大概率是 PhpStorm 绑定的 JSON Schema 太旧，不认识 config.platform.php、scripts.description 这类新版字段。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

立即学习“PHP免费学习笔记（深入）”；

• 进 Settings > Languages & Frameworks > Schemas and DTDs > JSON Schema Mappings
• 找到 composer.json 对应项，把 Schema URL 改成 https://raw.githubusercontent.com/composer/composer/main/res/composer-schema.json
• 删掉旧的映射再重新加，否则缓存可能不更新
• 改完后重启 PhpStorm，再打开 composer.json，标红消失、字段补全恢复

装了包但 PhpStorm 不识别类名

常见于 PSR-4 自动加载配置写错路径，或 PhpStorm 没把 src/ 正确识别为源根（Source Root）。

• 检查 composer.json 的 autoload.ps4 是否写对命名空间和路径，例如："App\": "src/"，且 src/ 目录确实存在
• 在 PhpStorm 左侧 Project 面板中，右键 src/ → Mark Directory as > Sources Root（没这选项说明路径不在项目根下）
• 如果用了 autoload-dev，对应测试目录也要标为 Test Sources Root
• 改完 composer.json 后，别只点右键 “Update Dependencies”——先手动运行 composer dump-autoload，再让 PhpStorm Reload

真正卡住人的地方，往往不是 composer install 成功与否，而是 PhpStorm 是否把 vendor/ 和 autoload.php 当作可信来源来索引——路径、Schema、源根标记，三者缺一不可。漏掉任意一个，类名就变灰色，Ctrl+Click 就失灵。