本地包必须用path仓库配合"*"约束，因Composer不识别本地路径版本号；写死版本如1.2.3会被当作远程包查找而失败，path仓库仅读取本地composer.json的version字段。
composer require 本地路径包时不能用冒号指定版本
本地包（比如 path 类型仓库）不走 Packagist，composer require vendor/name:1.2.3 这种写法会直接报错 Could not find a matching version。因为 Composer 在解析 path 包时，版本由其内部 composer.json 的 version 字段决定，不是你命令里写的那个。
正确做法是：先确保本地包根目录下的 composer.json 里明确写了 "version": "1.2.3"（注意不带 v 前缀），再在主项目中配置 repositories 并用 require 引入包名——版本自动取自本地文件。
- 本地包的
composer.json必须含version字段，否则 Composer 默认视为dev-main - 主项目
composer.json中需声明repositories，类型为path，指向该目录（支持通配符，如../packages/*） -
require字段只写包名，例如"myorg/mylocal-pkg": "*"或"myorg/mylocal-pkg": "1.2.3"—— 后者只是约束，实际是否匹配取决于本地composer.json的version - 运行
composer update myorg/mylocal-pkg触发重新解析，不要用install，它不会重新读取本地包元数据
本地包版本不生效？检查 source.type 和 symlink 行为
即使本地 composer.json 写了 "version": "1.2.3"，装完后 vendor/myorg/mylocal-pkg 下看到的仍是 dev-main 或 commit hash，大概率是因为 source.type 被设成了 git 或 svn，或者你用了 "symlink": true 但没清缓存。
Composer 对 path 包默认启用软链接（symlink），但 symlink 不读取目标包的 version 字段；它只按当前工作区 HEAD 解析。要强制认 version，必须关掉 symlink：
- 在主项目
composer.json的config段加"symlink": false - 删掉
vendor/和composer.lock中对应条目 - 运行
composer update myorg/mylocal-pkg --with-all-dependencies - 验证
composer.lock里该包的source.type是path，且version字段为"1.2.3"，不是"dev-main"
想让本地包像远程包一样支持 ^/~ 约束？不行，但可模拟
path 包不支持语义化版本漂移（^1.2、~1.2.0），因为没有 tag 或分支索引。你写 "myorg/mylocal-pkg": "^1.2"，Composer 仍只看本地 composer.json 的 version 是否满足——它不会去扫描你本地 Git 分支或打 tag。
若你真需要多版本本地开发，推荐两个务实方案：
- 用多个子目录，如
packages/mylocal-pkg-1.2和packages/mylocal-pkg-1.3，各自维护独立composer.json和version字段 - 改用
artifact仓库：把本地包打包成.zip，放在本地 HTTP 服务下，配置type: "package"+dist信息，这样就能用完整版本约束 - 别在生产流程中依赖
path包；它只适合开发联调，上线前务必切换为真实 Packagist 包或私有仓库
为什么 composer show -a 不显示本地包版本？
composer show -a vendor/name 只查远程源（Packagist 或你配置的其他 repositories），对 path 类型仓库完全无感知。它甚至不会尝试读取你本地文件系统里的 composer.json。
要确认本地包实际被识别的版本，唯一可靠方式是：
- 运行
composer update vendor/name --dry-run，看输出里解析出的version - 打开
composer.lock，找到该包条目，直接读version字段值 - 进
vendor/vendor/name目录，执行cat composer.json | grep version（前提是没开 symlink；开了就去原路径看）
本地包的“版本管理”本质上是静态快照，不是动态解析。写错 version 字段、忘记 update、或误启 symlink，三者任一都会让你以为指定了版本，其实根本没生效。
