composer路径需手动指定且必须有效，填错则静默失效；autoload不生效需手动重载项目；权限错误源于用户与工作目录不匹配；自定义scripts须通过external tools配置。
Composer executable 路径填错，PHPStorm 就当它不存在
PHPStorm 不会从系统 PATH 自动找 composer，必须手动指定一个能真正执行的路径。填错一个字符、选成软链接或 shell wrapper，IDE 就静默失效——既不报错，也不补全，连 composer.json 都不识别。
- 运行
which composer（macOS/Linux）或where composer（Windows），再用ls -l看它到底指向哪：常见是/opt/homebrew/bin/composer这种脚本，不是.phar - 直接搜
composer.phar：find /usr -name "composer.phar" 2>/dev/null；Windows 用户别选composer.bat，要找C:\ProgramData\ComposerSetup\bin\composer.phar - 填完务必点
Validate按钮——只有弹出版本号才算通过；若提示Could not open input file: /composer.phar，说明路径根本没指向可执行文件
autoload 不生效？不是配置错了，是索引没刷
即使 composer.phar 路径完全正确，vendor/autoload.php 里的类也照样不提示、Ctrl+点击跳不到源码。这不是 bug，是 PHPStorm 默认不主动加载 autoload 映射，得你亲手“推一把”。
- 右键项目根目录 →
Reload project from composer.json（该菜单只在识别到composer.json后出现） - 或者按
Ctrl+Alt+Y（Win/Linux）或Cmd+Alt+Y（macOS）触发Synchronize - 进
Settings → PHP → Composer，勾上Synchronize IDE settings with composer.json，后续改了autoload段会自动重载
执行 composer install 报权限错误？工作目录和用户权限对不上
PHPStorm 内置的 Composer 工具窗口（View → Tool Windows → Composer）默认以项目根为工作路径，但常因环境变量或用户身份导致写入失败，典型报错：Could not write to /path/to/vendor 或 file_put_contents(/path/to/composer.lock): failed to open stream。
- 确认当前用户对
vendor/、composer.lock、composer.json有读写权限——尤其 WSL、Docker 挂载卷或 NFS 共享目录下容易中招 - 别用
sudo phpstorm.sh启动 IDE；非要用 root 权限，改用sudo -u $USER phpstorm.sh - 检查 GUI 启动的 PHPStorm 是否加载了 Shell 配置（如
.zshrc里的COMPOSER_HOME）；可在Help → Edit Custom Properties中显式设置idea.config.path并保持环境一致
想用 composer run-script？得走 External Tools，不能靠内置 Composer 窗口
PHPStorm 的 Composer 工具窗口只支持标准命令（install、update、require），composer.json 里自定义的 scripts（比如 "test": "phpunit"）它压根不认，点了也没反应。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Tools → External Tools，点 + 新建工具 -
Name填Run PHPUnit；Program填composer（或绝对路径）；Arguments填run-script test；Working directory设为$ProjectFileDir$ - 之后就能从右键菜单或
Tools → External Tools一键触发，比切终端敲命令还快
