path仓库必须在主项目composer.json的repositories数组中声明为{"type":"path","url":"../sdk"}，且url需指向含composer.json的目录，name、路径、版本须与本地包完全一致，否则报“could not find package”。
path仓库必须写在主项目composer.json的repositories里，不是require字段
Composer根本不会从require字段读取路径——你写"acme/user-sdk": "../sdk"只会报Could not find package。它只认repositories数组里的{"type":"path","url":"../sdk"}这一种声明方式。
常见错误是把配置塞进本地包自己的composer.json，或者加到config或autoload下，这些位置Composer直接忽略。
-
repositories必须是根级数组，哪怕只有一个条目也要写成[{"type":"path","url":"../sdk"}] -
url必须指向含composer.json的目录，不能是文件，也不能以/结尾（"../sdk/"会静默失效） - Linux/macOS用相对路径最稳；Windows上绝对路径容易因盘符、空格、反斜杠中断，不推荐
name、路径、版本三者必须逐字对齐，大小写和分隔符都不能错
报Could not find package vendor/name，90%是因为这三个地方没对上：
- 本地包
composer.json里的name字段（如"acme/user-sdk"）必须和require中写的完全一致——"Acme/user-sdk"、"acme_user_sdk"、"acme/user_sdk"全都不行 -
url路径必须能从主项目composer.json所在目录出发抵达该composer.json，比如主项目在/work/order-api，本地包在/work/user-sdk，那就得写"../user-sdk"，不是"./user-sdk" - 版本约束只能用
dev-main、dev-develop这类分支名，不能写1.0.0或*——path源下version字段被忽略，Composer只看Git当前HEAD所在分支
改了本地代码不生效？大概率symlink没真正建立
默认行为是尝试创建符号链接，但失败时会静默回退到复制（copy），结果你改../user-sdk/src/Service.php，vendor/acme/user-sdk/src/Service.php还是旧的。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
关键不在主项目配"symlink": true，而在于**本地包自己的composer.json里是否声明了"options": {"symlink": true}**。缺这句，Windows管理员权限也白搭，Docker里更常fallback。
- 验证是否成功：
ls -la vendor/acme/user-sdk（Linux/macOS）应显示-> ../user-sdk；Windows用dir vendorcmeuser-sdk看是否为“JUNCTION”或“快捷方式” - 修改本地代码后，必须运行
composer update acme/user-sdk，不是dump-autoload，也不是install - CI/CD构建机上
../user-sdk路径必然不存在，所以path仓库仅限本地开发，上线前必须删掉repositories条目
autoload映射失效不是Composer没加载，而是路径没被正确注册
即使vendor/acme/user-sdk是有效软链，new UserService()仍报类找不到，问题往往出在autoload。
主项目不会自动继承本地包的autoload配置。如果本地包composer.json写了"psr-4": {"Acme\": "src/"}，但主项目composer.json没做任何autoload声明，那这个映射就不会生效。
- 方案一：在主项目
composer.json的autoload里手动加一条"psr-4": {"Acme\": "vendor/acme/user-sdk/src/"}，然后跑composer dump-autoload -o - 方案二（推荐）：确保本地包
composer.json里autoload配置合法，并在主项目执行composer update acme/user-sdk后，再补一次composer dump-autoload -o - Xdebug断点失效？检查IDE里打开的文件路径是否和
vendor/acme/user-sdk软链指向的真实磁盘路径一致，否则断点不会命中
APP_ENV=prod就自动禁用，也不会在composer install时跳过缺失路径——只要repositories里写了，就必须存在，否则直接中断。所以千万别把它提交进git。
