根本原因是composer install不扫描硬盘，只严格依据根composer.json中repositories字段声明的path源路径查找本地包，且要求目标目录存在合法composer.json且name与require完全一致。
composer install 为什么找不到本地包
根本原因不是网络或权限问题，而是 composer install 完全不扫描硬盘、不自动发现路径——它只认 repositories 字段里明确声明的 {"type": "path", "url": "..."} 条目，并且只在该 url 指向的**目录下找一个合法的 composer.json**。
常见错误现象：Could not find a matching version of package vendor/name。这通常意味着：
-
repositories没写进主项目的composer.json（写进本地包自己的composer.json无效） -
url写成绝对路径（尤其 Windows 上盘符/空格/反斜杠易静默失败），应改用相对路径如"../my-pkg" - 本地包目录下没有
composer.json，或其中name字段（如"acme/utils"）与require中写的不完全一致（大小写、分隔符、vendor 名全部敏感） -
url末尾多了/，如"../my-pkg/"，会导致整个仓库被忽略
vendor 目录里为啥不是符号链接
默认行为就是复制（copy），不是软链（symlink）。这是 Composer 的保守设计：保障构建可重现性，而非开发便利性。你改了 ../my-pkg/src/Helper.php，vendor/acme/utils/src/Helper.php 仍是旧副本。
要启用 symlink，必须满足三个条件：
- 本地包自己的
composer.json中含"options": {"symlink": true}（主项目repositories里配也行，但优先级低于本地包自身配置） - 系统支持：Linux/macOS 默认 OK；Windows 需开启“开发者模式”或以管理员权限运行终端；Docker 容器需加
--cap-add=SYS_ADMIN - 执行
composer update vendor/name（不是install，也不是dump-autoload）才会重建链接
验证是否成功：ls -la vendor/vendor/name 应显示 -> 箭头；Windows 下用 dir vendor endor
ame 看是否为“JUNCTION”或“快捷方式”类型。若显示普通文件夹，说明已 fallback 到 copy。
改了本地包代码，为什么 composer install 不生效
composer install 只负责按 composer.lock 还原状态：已有 symlink 就不动，缺失才补。它不会刷新链接目标路径，也不会重新解析本地包内容。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
本地包改了代码后想立刻生效，必须：
- 确保 symlink 已启用（见上一节）
- 运行
composer update vendor/name（指定包名，避免全量重算） - 注意：如果本地包
composer.json里version改了（比如从"dev-main"改成"1.0.0"），update仍可能跳过——因为 path 类型仓库忽略version字段，只认 Git HEAD 所在分支名
CI/CD 环境中，repositories 里的 path 条目必须移除，否则必然失败（路径不存在）；上线前务必清理。
autoload 为啥不加载本地包的类
symlink 创建成功 ≠ 类能被 new 或 use。Composer 只管“把包放进来”，类能否加载取决于 autoload 映射是否覆盖真实路径。
关键检查点：
- 本地包自己的
composer.json必须有正确autoload配置，例如"psr-4": {"Acme\": "src/"} - 主项目执行过
composer dump-autoload -o（优化模式），否则新增的 autoload 规则不会被注册 - Xdebug 断点失效？确认 IDE 中设置的路径与磁盘真实路径一致（比如 symlink 指向
/home/user/pkg，但 IDE 映射的是/Users/me/pkg）
最隐蔽的问题是：即使 symlink 成功，autoload 没更新，代码就“存在却不可用”。这个环节和 Composer 的仓库机制无关，纯属类加载器配置问题。
