必须确保vendor/autoload.php存在且可读，并将vendor目录标记为Sources Root，否则PhpStorm无法建立符号索引，导致Ctrl+B跳转失效、断点不命中；若用Docker/VM还需配置正确的路径映射。
不能直接跳转或调试 vendor 里的第三方类，除非 PhpStorm 明确知道这些类的源码位置和自动加载规则。 这不是 PhpStorm 的限制，而是它严格依赖 vendor/autoload.php 和目录标记来建立符号索引——没这俩，Ctrl+B 点进去就是“Cannot find declaration to go to”。
为什么 vendor 目录标红、Ctrl+B 失效
PhpStorm 不扫描 vendor 目录下的文件，除非你主动告诉它：“这部分是源码，要参与索引”。常见原因包括：
- vendor 目录被误标为
Excluded（右键 → Mark Directory as → Excluded） - vendor 目录没被标记为
Sources Root（右键 → Mark Directory as → Sources Root） -
vendor/autoload.php不存在，或路径不对（比如刚改完composer.json但没运行composer install） - 项目根目录下没有
composer.json，导致 PhpStorm 无法推断 autoload 规则
如何让 Ctrl+B 跳进 vendor 源码并设断点
关键动作只有两步，缺一不可：
- 确保
vendor/autoload.php文件真实存在且可读（用终端ls -l vendor/autoload.php验证） - 右键点击
vendor目录 →Mark Directory as→Sources Root（不是 “Resource Root”，也不是 “Test Sources Root”）
完成后，重启 PhpStorm 或手动触发 File → Reload project from disk。此时再 Ctrl+B 点击 Illuminate\Support\Str::before() 这类调用，就能跳进 vendor/illuminate/support/Str.php 并正常设断点。
立即学习“PHP免费学习笔记（深入）”；
调试时断点不命中 vendor 里的代码
即使能跳转，断点也可能不生效——本质是 Xdebug 的路径映射没对齐。常见表现：
- 断点显示为灰色圆圈（unresolved breakpoint）
- 执行到 vendor 方法时不暂停，反而跳进 Xdebug 自己的内部逻辑
- 调试器显示文件路径是
/var/www/html/vendor/...，但你的本地路径是/Users/me/project/vendor/...
解决方法：
- 进入
Settings → Languages & Frameworks → PHP → Servers，确认已配置服务器并勾选Use path mappings - 在路径映射表中，把远程路径（如
/var/www/html/vendor）映射到你本地的vendor目录绝对路径 - 如果只是本地开发（无 Docker/VM），路径映射通常留空即可；但一旦用了容器或远程解释器，这个映射必须精确
vendor 里改了源码想实时验证？别直接改
直接编辑 vendor 下的文件是临时且不可维护的。真正需要调试扩展行为时，应：
- 用
composer install --prefer-source安装包，这样会保留 Git 仓库，方便后续git diff或打补丁 - 若需长期修改，fork 该包 → 改成自己的私有 repo → 在
composer.json中用"repositories"指向它，并将版本约束改为"dev-main as 10.0.0"类形式 - 改完后务必运行
composer dump-autoload -o，否则 PhpStorm 仍按旧映射索引
最常被忽略的一点：vendor 目录是否被 Git 忽略不影响 PhpStorm 索引，但会影响你是否意识到自己正在改一个“随时会被 composer update 覆盖”的副本。
