Composer默认对path仓库执行复制而非软链接，必须显式配置"options": {"symlink": true}或"preferred-install": {"vendor/name": "source"}，并用composer update vendor/name触发，同时确保路径、包名、版本约束（如"@dev"）严格匹配。
直接用 path 类型仓库 + "symlink": true 配置，就能让多个本地 PHP 项目实时共享并调试同一个包，无需发布、不用 composer update 刷新——但前提是路径、包名、版本约束三者严丝合缝，缺一不可。
为什么 composer install 没创建软链接？
Composer 默认对 path 仓库的行为是「复制」，不是软链；哪怕你写了 "type": "path"，没显式启用 symlink，它就只是把文件拷一份进去。
- 必须在主项目的
composer.json的require条目里，为该包单独配"preferred-install": { "vendor/name": "source" }，或全局设"preferred-install": "source" - 或者更推荐：在
repositories项中为该仓库加"options": { "symlink": true }（注意不是放在config下） - Windows 用户需确认启用了开发者模式或以管理员身份运行命令行，否则
symlink会静默失败，退化为复制 - 执行的是
composer update vendor/name，不是install——install只读composer.lock，不触发 symlink 逻辑
path 仓库配置后包还是没加载？
最常见原因是路径或命名不匹配，Composer 会直接跳过该仓库，不报错也不提示。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
url值不能以./开头，必须是../my-package或绝对路径（如/Users/me/code/my-package） - 目标目录下必须存在合法的
composer.json，且其中"name"字段（如"acme/utils"）要和主项目require中写的完全一致（包括大小写、斜杠方向） -
require中的版本号不能写"^1.0"或"1.0.0"——path仓库不提供版本元数据，Composer 找不到匹配，会回退到 Packagist - 正确写法是
"dev-main"、"*@dev"或"dev-develop"，确保 Composer 知道你要走开发分支
改了本地包代码，主项目却还在用旧逻辑？
软链接建好了，不代表 PHP 就能立刻加载新代码——自动加载缓存和 OPcache 是两个高频卡点。
- 运行
composer dump-autoload --optimize（尤其当你启用了"classmap-authoritative": true） - CLI 环境下检查
opcache.enable_cli是否为0，否则php -f test.php会命中旧字节码 - Web 环境（如 PHP-FPM）需重启 FPM 进程，或调用
opcache_reset()清空缓存 - IDE（如 PHPStorm）可能缓存了类映射，手动触发 “Reload project from composer.json” 或清语言服务缓存
- 验证是否真走了 symlink：执行
ls -la vendor/vendor-name/package-name，输出应含-> /absolute/path/to/my-package
多包联调时如何避免手动重复配置？
当有 packages/utils、packages/api-client 等多个本地包时，硬编码每个 repositories 条目既冗余又难维护。
- 用通配符路径：
"url": "../packages/*"，Composer 会自动扫描匹配子目录下的所有有效composer.json - 每个子目录仍需独立、完整的
composer.json，且"name"必须全局唯一 - 通配符不支持嵌套（如
../packages/**/composer.json），只匹配一级子目录 - 若某子目录缺失
composer.json或"name"冲突，Composer 会跳过整个匹配，不会报错——建议先用composer validate检查各包
真正容易被忽略的，是 composer.lock 文件里的 "source" 字段：它决定了下次 install 是否复用 path 源。一旦你误运行了 composer update 而没带包名限定，Composer 可能从 Packagist 拉取稳定版并覆盖掉 symlink —— 所以日常开发中，优先用 composer update vendor/name 精确控制。
