vendor目录不生成软链接通常因repositories未显式设"type": "path"，而被当作vcs仓库处理；需确保url为项目内相对路径、目标包含有效composer.json且name与require完全一致，并清除vendor和composer.lock后重装。
composer.json里用path仓库时，vendor目录下不生成软链接
这通常不是路径写错，而是repositories类型没设对。用path方式本地开发扩展包，必须显式声明"type": "path"，否则 Composer 会把它当普通 VCS 仓库处理，跳过软链接逻辑。
检查点：
-
composer.json中repositories字段是否为数组，且每个项包含"type": "path"和"url": "./packages/my-package"（路径必须是相对当前项目根目录的） - 目标包目录（如
./packages/my-package）下必须存在有效的composer.json，且其中name字段与你require的包名完全一致（例如"my-vendor/my-package"） - 运行
composer update my-vendor/my-package --with-dependencies --dry-run，确认输出里有Skipped installation of my-vendor/my-package (symlink)字样；没有则说明未命中 path 模式
require后提示“Package not found”但路径明明存在
常见于路径拼写大小写不一致或符号链接权限问题。Linux/macOS 对路径大小写敏感，Windows 默认不敏感但 WSL 下可能表现异常；而 Composer 在解析path源时会严格校验文件系统真实路径。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
realpath ./packages/my-package确认实际路径，复制结果粘贴进repositories.url，避免../或~等模糊写法 - 检查目标包
composer.json里的autoload配置：若用"psr-4"，命名空间前缀必须与目录结构匹配，否则composer dump-autoload会失败，导致后续require报错 - 删掉
vendor/和composer.lock，再跑composer install——不要只update，因为 lock 文件可能缓存了旧的非 path 解析结果
多个path包互相依赖时循环引用失败
Composer 不支持 path 包之间的循环 require（A require B，B require A），即使都用path类型也会在update阶段报Root package requires ... but that version is not available，因为它无法构造出 DAG 依赖图。
解决方向：
- 把共用逻辑抽成第三个独立包（哪怕只是空壳），让 A 和 B 都
require它，而非彼此直连 - 临时用
"minimum-stability": "dev"+"prefer-stable": false配合dev-main版本约束，绕过 path 模式限制（仅限调试，勿提交） - 改用
artifact仓库类型：把各包打包成.zip放本地目录，用{"type": "artifact", "url": "./artifacts/"}统一管理，规避路径解析歧义
PHPStorm或IDE无法跳转到path包里的类
这不是 Composer 问题，而是 IDE 缓存没识别 symlink。PHPStorm 默认不跟随符号链接索引，即使vendor/my-vendor/my-package是软链，它也只扫描原始./packages/my-package目录下的文件，但不会自动加载其autoload规则。
关键动作：
- 右键点击
./packages/my-package→Mark Directory as → Sources Root - 打开
Settings → PHP → Include Paths，手动添加该目录，确保 IDE 知道这里要参与自动补全 - 执行
composer dump-autoload -o后，再在 IDE 中触发File → Reload project，否则 autoload 映射不会刷新
realpath和composer show --tree输出是否一致，比反复改composer.json更省时间。
