PhpStorm升级或重装后Composer路径需手动重填，且必须勾选“Synchronize IDE settings with composer.json”，修改autoload后须执行dump-autoload并手动Reload project。
Composer可执行路径迁移必须手动重填
PhpStorm升级或重装后，Path to composer.phar 不会自动继承——它被硬编码在旧版 options/other.xml 里，新版 IDE 启动时只读空配置。直接复制整个 config 目录看似省事，但一旦路径含中文、空格或符号链接，composer --version 就会在 IDE 内静默失败，右键菜单里的「Composer → Install」灰掉且无提示。
正确做法是：启动新版 PhpStorm 后，立刻进入 Settings → Languages & Frameworks → PHP → Composer，在 Path to composer.phar 栏手动填写：
- macOS/Linux：
/usr/local/bin/composer（全局安装）或which composer输出的路径 - Windows：
C:\ProgramData\ComposerSetup\bin\composer.bat或where composer返回的路径 - 绝对不要填项目根目录下的
composer.phar，那只是可执行文件副本，不是 CLI 入口
composer.json 同步开关容易被忽略
即使 composer.phar 路径正确，IDE 仍可能不识别 vendor 中的类——根源常是 Synchronize IDE settings with composer.json 这个开关没勾选。它控制两件事：自动加载规则是否生效、autoload 和 autoload-dev 路径是否加入索引。
这个选项默认关闭，尤其在从旧版导入设置时不会自动启用。检查方法：
立即学习“PHP免费学习笔记（深入）”；
- 打开任意
composer.json，修改其中"psr-4"映射，保存后看右下角是否弹出「Reload project」提示 - 若无提示，说明同步未启用；手动勾选后，再右键项目根目录 →
Reload project - 改完 autoload 后必须执行
composer dump-autoload -o，否则 PhpStorm 索引不到新映射的类
离线迁移 vendor 目录比重装依赖更可靠
跨机器或离线环境迁移时，别指望在新机器上跑 composer install —— 它会因网络不通、源站不可达或哈希校验失败而中断。真正能落地的方案是直接搬运 vendor 目录，但有硬性前提：
- 源机和目标机的 PHP 小版本必须一致（如都是
8.2.12），否则opcache或扩展兼容性会触发运行时错误 - 搬运前在源机执行：
composer install --no-dev --optimize-autoloader，再用最小脚本验证：require 'vendor/autoload.php'; var_dump(class_exists('GuzzleHttp\Client')); - 目标机解压后，立即运行：
composer dump-autoload -o，修复 symlink 权限或路径污染问题 -
composer.lock必须随vendor一起迁移，它是校验包完整性的唯一依据
插件与自动加载的耦合关系
某些插件（如 Laravel Plugin、Symfony Support）依赖 Composer 的 autoload 信息才能激活高级功能。如果迁移后 Blade 模板跳转失效、路由无法识别，不是插件没启用，而是 autoload 没同步成功。
排查顺序很关键：
- 先确认
Settings → PHP → Composer → Autoloading files列表里是否包含vendor/autoload.php - 若为空，点击右侧
Reload project from composer.json按钮（不是「Reload project」菜单项） - 再检查
Settings → Plugins中对应框架插件是否启用，禁用后重启 IDE 再启用一次 - 最后清缓存：
File → Invalidate Caches and Restart → Invalidate and Restart，避免旧索引残留干扰
composer.json 修改后的主动 reload 动作——PhpStorm 不会监听文件内容变更，只响应保存事件后的显式操作。 
