跳转失败主因是 autoload 映射未生效：需运行 composer install/update 生成 autoload_*.php，确认 PSR-4 前缀末尾有反斜杠，启用 PhpStorm 的 Follow symlinks，最后手动重载项目或刷新索引。

跳转到 vendor 类定义失败，核心是 autoload 映射没生效

IDE 跳不到 GuzzleHttpClient 或 IlluminateSupportStr，不是 PhpStorm 坏了，而是它依赖的映射文件还没生成或没被读取。Composer 的 vendor/composer/autoload_*.php（比如 autoload_psr4.php）才是真实“类→路径”的对照表，IDE 只是解析它——没这文件，或内容旧，跳转必然失效。

• 运行过 composer install 或 composer update 才会生成/更新这些 autoload 文件；只改了 composer.json 但没重装，映射还是空的或旧的
• 本地 path 类型包（如 "monolog/monolog": "path: ../monolog"）在 vendor/ 下是符号链接，需在 PhpStorm 设置里开启 Follow symlinks
• PSR-4 前缀末尾漏反斜杠（例如写成 "App": "src/" 而非 "App\": "src/"）会导致整个命名空间不匹配，类名完全查不到映射

确认 vendor 包物理路径最准的方式是用命令行

别靠记忆或猜路径，composer show --path 是唯一可靠入口。它输出的是包根目录的绝对路径，结尾带 /，可直接粘贴进文件管理器或终端。

• 必须 Composer 2.2+ 才支持 --path；旧版本报错时，用 composer config vendor-dir --absolute 拿基础路径，再拼上 vendor-name/package-name
• 包名大小写敏感：monolog/monolog ≠ Monolog/Monolog；不确定时先 composer show | grep -i monolog
• 输出的是包根目录，不是 src/；要打开具体类，还得结合该包自己的 autoload 规则（比如 GuzzleHttp → src/）

PhpStorm 必须重新索引才能识别新映射

即使 vendor/composer/autoload_psr4.php 已存在且正确，PhpStorm 也不会自动加载它。你得手动触发索引刷新，否则补全、跳转、类型提示全部滞后。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 右键项目根目录 → Reload project from composer.json（这个选项只在识别到 composer.json 后出现）
• 或按快捷键 Ctrl + Alt + Y（Windows/Linux） / Cmd + Alt + Y（macOS）执行 Synchronize
• 检查 Settings → PHP → Composer 是否勾选了 Synchronize IDE settings with composer.json，否则改了配置也不会自动响应

类名反查包名：直接搜 autoload_classmap.php

看到一个陌生类（比如 IlluminateSupportStr），别去翻文档或瞎猜，vendor/composer/autoload_classmap.php 就是 Composer 实际加载时用的原始映射源，100%准确。

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

• 打开该文件，搜索类名全称（含命名空间，不加 开头，例如搜 IlluminateSupportStr）
• 找到类似 'IlluminateSupportStr' => $vendorDir . '/illuminate/support/src/Str.php' 的条目，前半段是类名，后半段路径里的 illuminate/support 就是包名
• 这个方法对动态 require、非标准 autoload（如某些老包用 classmap 手动注册）尤其有效，比看 composer.json 更底层、更可靠

实际跳转卡住时，顺序检查这四点：autoload 文件是否存在 → vendor 路径是否被排除 → 符号链接是否启用 → IDE 索引是否刷新。少一步，就白装。