Composer本地Path仓库配置必须在项目根composer.json的repositories数组中声明，type为"path"，url为相对路径（如"./packages/my-utils"），且本地包name须与require完全一致，否则静默忽略。
Composer本地Path仓库能让你直接用磁盘上的PHP包，但90%的失败不是因为不会配，而是name或url和实际路径/内容不一致——它不模糊匹配，错一个字符、多一个斜杠、大小写不对，就静默忽略整个仓库。
怎么写repositories配置才有效
必须在项目根目录的composer.json里加repositories，不能写在本地包自己的composer.json中。类型固定为"type": "path"，url值是相对于该项目composer.json的路径（不是当前shell位置），且不能以/开头或结尾：
-
"url": "./packages/my-utils"✅（推荐，跨机器可移植） -
"url": "/home/user/pkg"✅（绝对路径，慎用） -
"url": "../my-utils/"❌（末尾/会导致仓库被跳过） -
"url": "packages/my-utils"❌（缺./前缀，Composer会当成远程URL去解析）
Windows用户注意：路径中避免中文、空格；Git Bash下若url含~或环境变量，也会失效。
name字段必须逐字对齐，连短横线都不能错
本地包根目录下的composer.json必须有合法name，且和你在项目require里写的**完全一致**：大小写、分隔符（只允许短横线-）、vendor名全部对齐。例如：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 本地包
composer.json里写"name": "acme/utils"→ 项目require必须写"acme/utils": "dev-main" -
"Acme/utils"、"acme_utils"、"acme:utils"全部不匹配 - 检查方式：
composer show --all | grep acme，如果没输出，说明name或路径根本没被识别
别信“应该差不多”，Composer不做任何转换或容错——它只做字符串全等判断。
为什么改了代码没生效？大概率是symlink没真启用
Path仓库默认尝试创建符号链接，但失败时会静默 fallback 到复制（copy），结果你改本地源码，vendor/里还是旧副本。关键点不在主项目配"symlink": true，而在于本地包自己的composer.json里是否声明了"options": {"symlink": true}：
- 缺这句，Windows即使管理员权限运行终端，也会 fallback
- Docker容器挂载宿主机目录时，常因
--cap-add=SYS_ADMIN缺失导致 symlink 失败 - 验证是否真用了 symlink：
ls -la vendor/acme/utils（Linux/macOS）看到->箭头，或dir vendor\acme\utils（Windows）看到JUNCTION才表示成功 - 如果显示为普通文件夹，立刻检查本地包
composer.json是否漏了options段
autoload不生效？不是没加载，是映射没更新
Path仓库让包“存在”，但new Acme\Foo()能否成功，取决于autoload映射是否指向你本地的真实路径。即使本地包composer.json写了"psr-4": {"Acme": "src/"}，主项目也不会自动继承——你必须手动执行：
-
composer dump-autoload -o（加-o确保优化后映射准确） - 如果仍不行，确认本地包
src/路径下确实有对应命名空间的PHP文件，且文件名大小写与类名严格一致（Linux/macOS敏感） - IDE（如PHPStorm）默认只索引
vendor/，需手动在Settings → PHP → Include Paths中添加本地包根目录
最隐蔽的坑是：你以为改了composer.json就能热更新，其实autoload映射是一次性生成的，不手动刷，它就不动。
