本地包版本约束必须显式声明为path类型，需在repositories中注册type为path的仓库，url为相对或绝对路径，require中只能用"*"，其他语义化版本符无效，实际版本由本地包composer.json的version字段决定。
本地包的版本约束必须显式声明为 path 类型
Composer 默认不识别本地文件路径作为包源，直接写 "vendor/package": "1.2.3" 会报 Could not find package。你得先在 composer.json 的 repositories 里注册一个 path 类型仓库，否则任何版本约束都无效。
正确配置示例：
{
"repositories": [
{
"type": "path",
"url": "./packages/my-local-package"
}
],
"require": {
"my-vendor/my-local-package": "*"
}
}
关键点：
-
url必须是相对于项目根目录的**绝对路径或相对路径**，不能是 URL 或 git 地址 -
type必须为path，不是package或vcs - 本地包目录下必须有合法的
composer.json，且其中name字段要和require中一致 -
"*"是唯一推荐的约束写法——它会读取本地包composer.json里的version字段，而不是去 Packagist 查
本地包不能用 ^、~、= 等语义化约束符
如果你对本地包写 "my-vendor/my-local-package": "^1.2.0"，Composer 会忽略该约束，仍按本地 composer.json 中的 version 值安装，并可能报 warning：Skipped tag v1.2.0, no composer.json found（如果本地没打 Git tag）。
原因在于：path 类型仓库不参与语义化版本解析，它只做“软链接式”挂载。所有 ^、~、=、@stable 都会被跳过。
所以：
- 别写
^1.2.0、~1.2、=1.2.3—— 它们不起作用，还可能误导后续维护者 - 也别写
dev-main或1.2.3@stable——path不支持分支或稳定性标记 - 想“锁定”本地包内容，靠的是 Git commit hash 或文件系统状态，不是版本字符串
本地包的 version 字段决定实际加载行为
Composer 读取本地包时，真正起作用的是其内部 composer.json 中的 version 字段。这个值会覆盖你在主项目中写的任何约束（哪怕你写了 "*"）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
比如本地包 ./packages/foo/composer.json 写着：
{
"name": "acme/foo",
"version": "dev-main"
}
那么无论主项目写 "acme/foo": "*" 还是 "acme/foo": "1.0.0"，最终装进去的都是 dev-main 快照。
常见陷阱：
- 本地包没写
version字段 → Composer 报错Package acme/foo has no version set - 本地包写了
"version": "1.2.3"，但你改了代码没更新字段 →composer install不会重装，缓存命中后内容不一致 - 本地包
version是dev-main，而主项目minimum-stability是stable→ 装不上，需加--stability=dev或临时调低全局稳定性
开发调试时如何强制刷新本地包内容
改了本地包代码却没生效？不是版本约束问题，而是 Composer 缓存或 symlink 没更新。最可靠的方式是三步走：
- 删掉
vendor/acme/foo目录（不要只删vendor/composer/autoload_*.php） - 运行
composer dump-autoload清理自动加载缓存 - 再执行
composer install—— 此时会重新解析path并重建 symlink
注意：不要用 composer update acme/foo，它对 path 类型无效；也不要依赖 --no-cache，本地包不走远程缓存机制。
真正难的不是写对 repositories，而是记住：本地包的“版本”本质是文件系统快照，不是语义化标签。一旦你把它当成普通远程包来约束，就注定踩坑。
