结论:必须用path仓库+dev-main版本+symlink选项才能实时生效;仅执行composer require vendor/name必然失败,因Composer默认不扫描本地路径,须先在主项目composer.json的repositories中显式声明合法path源。

直接说结论:用 path 类型仓库 + dev-main 分支别名 + symlink 选项,才能边改本地代码边实时生效;只写 composer require vendor/name 肯定失败,因为 Composer 根本“看不见”你硬盘上的那个文件夹。
为什么 composer require 找不到本地包
Composer 默认只查 Packagist 和已声明的仓库,不会扫描你电脑上任意路径。没配 repositories,它连目录是否存在都不知道,报错一定是 Could not find package xxx,不是网络问题,也不是权限问题。
-
repositories必须写在主项目根目录的composer.json里,不能写在子目录或扩展包自己的composer.json中 -
url值必须是相对于主项目composer.json的路径,比如"./packages/my-package";用../跨出项目根目录会被 Composer 拒绝 - 本地包目录下必须有合法的
composer.json,且至少包含"name"(大小写敏感)和"version": "dev-main" - 如果本地包没初始化 Git(
git init && git add . && git commit -m "init"),Composer 会静默跳过该路径,不报错也不加载
composer require 时该写什么版本号
Path 仓库不走语义化版本解析,只认分支名或 dev- 开头的别名。写 "^1.0" 或 "*" 一定失败。
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 本地包
composer.json里"version"是"dev-main",require 就得写vendor/name:dev-main - 主项目
composer.json顶层要加"minimum-stability": "dev",否则dev-main被稳定性策略过滤掉 - 推荐同时加
"prefer-stable": true,避免意外拉到不稳定依赖 - Windows 下若想改代码立即生效,
repositories条目里必须显式加"options": {"symlink": true};Linux/macOS 默认软链,但加了更明确
改了本地包代码,vendor 里为啥没变
默认行为是复制,不是监听。改 ./packages/my-package/src/ 不会自动同步到 vendor/vendor/name/。
- 启用符号链接后,
vendor/vendor/name实际是软链接指向原目录,改源码即生效 - 没启 symlink?那就得手动触发重映射:
composer update vendor/name(只更新这个包) -
composer dump-autoload只刷新类自动加载映射,不更新文件内容,别指望它让新代码跑起来 - 千万别删
vendor/再composer install——这会让本地包被完整复制进vendor,彻底失去调试意义 - 验证是否生效:进
vendor/vendor/name目录,ls -l看是不是软链接(Unix)或检查修改时间是否和源目录一致(Windows)
装上了但 Class not found 怎么办
90% 是 autoload 或框架注册问题,跟 Composer 加载本身无关。
- 确认本地包
composer.json里autoload正确,例如{"psr-4": {"MyVendor\MyPackage\": "src/"}};斜杠方向、末尾多一个、路径少一级,全都会导致找不到类 - 运行
composer dump-autoload(开发阶段不用加-o),否则新命名空间不会写入vendor/autoload.php - 如果包提供 Laravel Service Provider 或 ThinkPHP 的服务类,必须手动在
config/app.php的providers数组里注册;Composer 不处理这部分 - ThinkPHP 还要检查有没有
"dont-discover": ["*"],有就删掉或缩小范围
最容易被忽略的是 Git 初始化和 symlink 选项——尤其在 Windows 上,缺一不可。路径对齐、命名空间对齐、分支名对齐,三者缺一个,require 就只是个摆设。

















