path仓库必须配置在repositories数组中而非require字段，需声明"type": "path"及合法url，本地包composer.json的name、version（或dev-main）和autoload必须完备，否则无法识别或类加载失败。
path仓库必须写在repositories里，不是require里
直接在require字段里写"vendor/name": "./local"或加"path"键——完全无效。Composer 不解析require里的路径语义，只把它当版本约束字符串处理。报错Could not find package vendor/name at version *，往往就卡在这一步。
正确做法是：在项目根目录的composer.json中，和require同级的位置添加repositories数组：
{
"repositories": [
{
"type": "path",
"url": "../my-package"
}
],
"require": {
"vendor/my-package": "dev-main"
}
}注意三点：
-
url必须是相对路径（以../或./开头）或绝对路径，不能带file://前缀，也不能用~/ -
url指向的目录必须已存在，且包含合法的composer.json（无语法错误、双引号、无尾逗号） -
require中的包名（vendor/my-package）必须和本地包composer.json里的name字段**完全一致**
为什么vendor里是复制而不是symlink
Composer 默认对path仓库也执行复制操作，这是为了构建可重现性。软链接不是默认行为，必须显式启用，且仅对path类型生效。
最可靠的方式：在**本地包自己的composer.json** 中添加：
{
"name": "vendor/my-package",
"options": {
"symlink": true
}
}不是主项目的配置，也不是全局设置——这个options字段必须出现在被链接的包内部。
常见失败原因：
- Composer 版本低于 2.2（
symlink支持始于 2.2） -
composer install不触发 symlink；必须运行composer update vendor/my-package或全量composer update - 路径权限问题（Windows 需启用“开发者模式”或以管理员身份运行）
验证是否成功：ls -la vendor/vendor/my-package（macOS/Linux）应显示-> ../my-package；Windows 可用dir vendor\vendor\my-package看是否为“快捷方式”或符号链接。
require写什么版本才能匹配本地包
path仓库不走语义化版本解析，它只做字符串比对。你require的版本必须和本地包composer.json里的version字段值，或 Git 分支名（如dev-main、dev-develop）严格一致。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
例如，本地包composer.json是：
{
"name": "vendor/my-package",
"version": "1.0.0-dev",
"autoload": { ... }
}那么require必须写"vendor/my-package": "1.0.0-dev"，写"*"或"dev-main"都会失败。
更灵活的做法是：不设version字段，改用分支名，并确保 Git HEAD 在对应分支上。此时require写"dev-main"即可，Composer 会自动识别当前分支。
注意：composer update时若提示“no matching package found”，优先检查这个版本字符串是否拼写一致、大小写是否匹配、有无空格。
通配符路径和团队协作注意事项
多个本地包可统一管理，用通配符简化配置：
{
"repositories": [
{
"type": "path",
"url": "../packages/*"
}
]
}Composer 会扫描../packages/下所有含合法composer.json的子目录，并按其name字段注册为可用包。
但团队协作时，硬编码../packages/*容易出问题：
- 不同成员路径结构不一致（比如有人放
~/code/packages） - CI 环境没有这些本地路径，导致
composer install失败
推荐方案：
- 开发时保留
repositories配置，但 CI 流程中用composer config --unset repositories临时清空 - 或用环境变量控制，如
"url": "${PACKAGES_PATH}/*"（需配合composer config --global repositories.0.url动态注入） - 上线前务必从
composer.json中移除path仓库配置，否则可能意外覆盖线上包源
最容易被忽略的一点：软链接生效后，你在vendor/里修改代码，实际改的是源目录——这不是 bug，是设计如此。但很多人误以为改了vendor就能热更新，结果发现主项目没变，其实是 autoload 没重载，得跑一遍composer dump-autoload。
