答案是先确认包名与require中逐字一致（大小写、分隔符），再验证本地路径真实存在且含合法composer.json；name必须为小写vendor/name，路径不能以/结尾，目录须可读且json无语法错误。
“Could not find a matching version”根本不是版本问题，而是name或路径没对上
报这个错时，90%的情况根本不是你写的版本号（比如"*"或"dev-main"）有问题，而是Composer压根没加载到你的本地包——它连包名都“看不见”。关键检查点就两个：name字段是否和require里写的**逐字一致**，以及url指向的目录是否**真实存在且含有效composer.json**。
常见错误现象：composer show --all输出里完全不出现你的vendor/name，或者composer require vendor/name直接报错“Package not found”。
-
name必须大小写、分隔符（仅允许短横线-）完全一致，"acme/utils"≠"Acme/utils"≠"acme_utils" -
url是相对于主项目composer.json的位置，例如"../my-pkg"，不能是"./packages/my-pkg"（当前目录）或绝对路径（除非所有环境都一致） - 路径末尾不能加
/，"url": "../my-pkg/"会被静默忽略 - 用
ls -la ../my-pkg（Linux/macOS）或dir ..my-pkg（Windows）确认该目录存在且可读
本地包的composer.json必须合法且含name和version
Path仓库不会校验语法，但只要composer.json有尾逗号、单引号、中文标点或缺name/version，Composer就会跳过整个包——不报错，也不注册，就像它不存在一样。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 用
json_decode(file_get_contents('composer.json'), true)或在线JSON校验工具验证语法 -
name字段必须存在，且格式为"vendor/name"（全小写、短横线） -
version字段建议显式填写（如"1.0.0"），否则Composer可能 fallback 到dev-main，但某些约束（如"^1.0"）会不匹配 - 如果只打算本地开发，
version可设为"dev-master"并配合"minimum-stability": "dev"使用
符号链接失败导致你以为在改源码，其实改的是副本
Path仓库默认尝试创建symlink，但失败时会静默fallback到copy模式。结果就是：你改了../my-pkg/src/，vendor/vendor/name/里还是旧代码——autoload生效，但逻辑没变。
- 验证是否真用了symlink：
ls -la vendor/vendor/name（Linux/macOS）看到箭头，或dir vendor endor ame（Windows）看到JUNCTION才对 - 真正控制symlink开关的不是主项目的配置，而是**本地包自己的
composer.json中是否含"options": {"symlink": true}** - Windows用户必须以管理员身份运行终端；Docker需
--cap-add=SYS_ADMIN且挂载方式支持symlink - 不想折腾symlink？在path仓库配置里加
"options": {"symlink": false}，强制复制，再配合composer dump-autoload -o更新映射
autoload映射没更新，类能use但new时报Class not found
Path仓库让包“被发现”，但类能否加载，取决于autoload规则是否覆盖了本地包的真实路径。即使本地包composer.json写了"psr-4": {"Acme\": "src/"}，主项目也不会自动继承——必须手动刷新。
- 每次改完本地包的
composer.jsonautoload段，都要在主项目执行composer dump-autoload -o - 如果本地包用的是
classmap或files，也要确保路径指向的是它自己目录下的文件，不是相对主项目的路径 - Xdebug断点不命中？检查IDE里配置的路径是否和磁盘实际路径一致（尤其Windows下长路径、空格、中文）
repositories就万事大吉——其实name、路径、symlink、autoload这四关，漏一关就白配。
