本地包需三要素对齐(name、version、autoload)、启用symlink且完成git init,才能通过composer require path仓库实时生效;否则静默跳过或Class not found。

直接用 composer require + path 仓库配置,就能让本地包改完即生效——前提是三要素对齐、symlink 开启、且不跳过 git init 这步。
本地包必须有合法的 composer.json 并完成 Git 初始化
Composer 的 path 类型仓库不是“看目录就加载”,而是会检查该路径下是否存在已提交的 Git 仓库。没 git init && git add . && git commit -m "init",它就当这个目录不存在,静默跳过,不报错也不提示。
-
name字段必须和你在composer require时写的完全一致(大小写敏感),例如"myvendor/mypackage" -
version推荐设为"dev-main",不要留空或写"1.0.0";否则在未设minimum-stability时会被过滤 -
autoload必须声明 PSR-4,比如{"psr-4": {"MyVendor\MyPackage\": "src/"}};斜杠方向、末尾反斜杠、路径拼错一位都会导致Class not found - 别信
composer init生成的默认值:type要手动补成"library"或"laravel-package",否则 Laravel 自动发现不触发
项目根目录 composer.json 必须正确配 repositories
配置必须写在项目根目录的 composer.json 根级 repositories 数组里,写错位置(比如塞进 config 或 extra)等于没写。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
url是相对于项目composer.json的路径,只能用"./packages/mypackage"这种,不能用../跨出项目根,也不能用绝对路径 - 必须显式加上
"options": {"symlink": true},尤其 Windows 下不写这句就是复制模式,改源码不会反映到vendor/ - 整个
repositories是数组,哪怕只加一个也要写成[{"type":"path","url":"./packages/mypackage","options":{"symlink":true}}] - 配完别忘了删掉
composer.lock和vendor/,再跑composer install—— 缓存可能让新仓库被忽略
require 时必须用分支别名,且项目要放宽稳定性策略
path 仓库不走语义化版本解析,"^1.0" 或 "*" 全部无效,只认 dev- 开头的分支名。
- 执行命令:
composer require myvendor/mypackage:dev-main - 项目
composer.json顶层必须有"minimum-stability": "dev",否则dev-main直接被过滤,报Could not find a matching version - 推荐同时加
"prefer-stable": true,兼顾开发灵活性和线上依赖稳定性 - 如果本地包分支叫
dev-feature,那version和require都得同步改成"dev-feature",不一致就找不到
改代码后不生效?先确认 symlink 和 autoload
改了 ./packages/mypackage/src/ 却发现 vendor/myvendor/mypackage 没变,大概率是链接没建起来,或自动加载缓存没刷。
- Linux/macOS 下进
vendor/myvendor/mypackage执行ls -l,看是不是指向源目录的软链接;不是的话说明symlink: true没生效或被忽略 - Windows 用户请确认命令行是否以管理员权限运行(部分系统需权限才能建符号链接)
- 运行
composer dump-autoload刷新命名空间映射,尤其当你新增了类或改了autoload配置 - 别用
composer update全局重算依赖树——只要更新指定包:composer update myvendor/mypackage
最容易被忽略的是:本地包目录下没 git commit,以及 repositories 写在了错误层级或用了非法路径。这两点不满足,其他操作全白搭。

















