必须在主项目composer.json的repositories中配置{"type":"path","url":"./packages/my-local-package"},本地包需含合法composer.json(含name和version字段),require中只能写"*",改代码后须执行composer update vendor/name才能生效。

用 path 仓库挂载本地包,不是加 require 就完事
直接在 composer.json 的 require 里写 "vendor/name": "dev-main" 是无效的——Composer 根本不会去找你本地目录,除非你先告诉它“那里有个包”。必须在 repositories 块里显式注册:
"repositories": [
{
"type": "path",
"url": "./packages/my-local-package"
}
]
注意三点:
-
url是相对于项目根目录的路径,不能用~/或绝对路径(Composer 2.4+ 会拒绝) - 目标目录下必须有合法
composer.json,至少含name和version字段(如"version": "dev-main") - 改完后要运行
composer update vendor/name,不是install;否则缓存可能跳过新仓库
require 里只能写 "*",别信 dev-main 或 1.2.3
path 类型仓库不走语义化版本解析,"vendor/name": "dev-main" 会报 Invalid version string,"^1.2" 则静默失效。唯一可靠写法是:
"vendor/name": "*"
Composer 此时只读取本地包 composer.json 里的 version 字段,并原样采纳。所以想“切分支”,直接改本地包的 version 值(比如从 "dev-main" 改成 "dev-feature/x"),再跑一次 composer update vendor/name 即可生效。
改了本地代码,vendor 里没变?那是你没重映射
path 仓库在 Linux/macOS 下创建的是符号链接,在 Windows 下是硬链接或复制,但都不是实时同步。改了 ./packages/my-local-package/src/Helper.php,vendor/vendor/name/src/Helper.php 不会自动更新。必须手动触发:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 推荐:运行
composer update vendor/name(只重映射该包) - 次选:
composer dump-autoload(仅刷新自动加载,不更新文件) - 千万别删
vendor/后install——这会让 Composer 把本地包完整复制进去,失去“改即生效”的调试意义
验证是否成功:进 vendor/vendor/name 目录,ls -l 看是不是软链接(Unix)或检查文件修改时间(Windows)。
composer link 不适合新手,且只对已安装包有效
composer link 是个快捷操作,但它有硬性前提:目标包必须已经通过 composer require 安装过,且你得在本地包目录里执行它。流程是:
- 先在主项目中
composer require vendor/name - cd 进本地包目录,执行
composer link - 回到主项目,再执行一次
composer link vendor/name
问题在于:composer link 不修改 composer.lock,也不刷新 autoload,后续 composer update 极易覆盖掉这个软链接。它适合快速验证,但不适合长期开发——稍不注意就退回到远程包。
最易被忽略的一点:path 仓库的 url 路径权限和拼写错误,往往比逻辑问题更难排查。CI 环境里常见路径不存在、用户无读取权限、或大小写不一致(尤其 macOS 默认不区分大小写,Linux 严格区分),这些都会导致 composer show vendor/name 返回 Package not found,但错误信息里根本不会提。










