根本原因是autoload映射路径与本地源码路径不一致：path仓库启用symlink后，vendor中为符号链接，但IDE默认不跟随，且autoload_psr4.php记录的是链接目标的绝对路径，与编辑器打开的相对路径不匹配。

为什么“Go to Definition”在 vendor 里跳不到本地包源码

根本不是 IDE 坏了，而是 Composer 生成的 autoload 映射路径和你编辑的源码路径不一致。当本地包通过 path 仓库引入且启用 symlink 后，vendor/vendor/name 是个符号链接，但 IDE 默认不跟随、或 autoload_psr4.php 里记录的是链接目标的绝对路径（比如 /home/user/my-pkg/src/），而你的 IDE 打开的是 ../my-pkg 这个相对路径下的文件——断点和跳转就全失效。

• PHPStorm 需手动开启 Settings > Editor > General > Appearance > “Follow symbolic links”
• VS Code 的 PHP Intelephense 或 PHP Tools 插件需在设置里启用 "intelephense.environment.followLinks": true
• 检查 vendor/composer/autoload_psr4.php，搜索你的命名空间前缀（如 "MyCompany\":），确认右边路径是真实磁盘路径，不是软链接路径本身
• 若映射路径是 $vendorDir . '/mycompany/pkg/src/'，但你的编辑器打开的是 ../my-pkg/src/，就得在 IDE 的 path mappings 中显式把前者映射到后者

如何让 PhpStorm / VS Code 正确识别 symlink 源码路径

IDE 不会自动猜你“想跳去哪”，必须告诉它 symlink 的真实指向。尤其当你用 ../my-pkg 这种相对路径配 path 仓库时，Composer 解析出的绝对路径和你在编辑器里打开的路径极可能不同。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• PHPStorm：进入 Settings > Languages & Frameworks > PHP > Composer，勾选 “Enable auto-detection of path repositories”；再右键项目根目录 → “Reload project from composer.json”
• VS Code：安装 composer-json 插件后，执行命令 Composer: Reload project，确保它读取了最新 autoload_psr4.php
• 关键一步：在 IDE 的调试/运行配置中，手动添加 path mappings，例如将 /var/www/project/vendor/mycompany/pkg 映射到 /home/user/my-pkg（即你实际编辑的目录）
• 别依赖“自动索引”——改完本地包 composer.json 后，必须跑一次 composer dump-autoload，否则 IDE 看不到新类

本地包自己的 composer.json 必须带 symlink 选项

很多人只在主项目加 repositories，却忘了本地包自己也要“同意被链接”。缺这句，Composer 就静默 fallback 到 copy 模式，vendor/ 里压根不是链接，IDE 自然找不到源码。

• 在本地包根目录的 composer.json 里，必须包含：

  "options": {
    "symlink": true
  }

• Windows 用户要以管理员身份运行终端，否则 symlink 创建失败且无提示
• Docker 场景下，宿主机挂载目录需支持符号链接（比如用 docker run -v $(pwd)/../my-pkg:/workspace/my-pkg:delegated 不行，得确保 --cap-add=SYS_ADMIN 且挂载方式透传权限）
• 验证是否真成功：Linux/macOS 下执行 ls -la vendor/mycompany/pkg，看到 -> ../my-pkg 才算对；Windows 下用 dir vendormycompanypkg，看到 SymLinkD 或 Junction

autoload 映射不更新？先看 dump-autoload 是否真生效

改了本地包的 autoload 配置（比如新增了 "psr-4": {"MyCompany\Tests\": "tests/"}），但 IDE 还是跳不到测试类——大概率是 composer dump-autoload 没跑对，或者没加 --dev 参数。

• 如果新增的是 autoload-dev 下的路径（如 tests/, factories/），必须加 --dev：composer dump-autoload --dev
• 加 -v 参数看详细输出：composer dump-autoload -v，确认日志里出现你的命名空间（如 MyCompany\）并扫描到了对应目录
• 检查 vendor/composer/autoload_psr4.php 文件末尾，是否新增了对应条目；若没有，说明 composer.json 有语法错误（BOM、尾逗号、单引号）
• PSR-4 前缀末尾必须带反斜杠："MyCompany\" ✅，"MyCompany" ❌——少这个反斜杠，整个命名空间映射就失效

跳转失效最常卡在 symlink 路径和 autoload 映射的错位上，而不是 IDE 设置本身。先验证链接是否存在、再确认映射路径是否真实可访问、最后才调 IDE 配置——顺序错了，花半天调设置也没用。