必须确认 symlink 是否真正建成:vendor/vendor/name 应为符号链接(Linux/macOS 显示 ->,Windows 为快捷方式),否则改本地代码无效;常见原因包括 repositories 未写在主项目 composer.json、未配 "options": {"symlink": true}、Windows 未开开发者模式或未用管理员权限、误执行 install/dump-autoload 而非 update vendor/name。

本地包改了代码,单元测试不生效?先确认 symlink 是否真建成了
本地包用 path 类型仓库接入后,vendor/vendor/name 目录必须是符号链接(Linux/macOS 下 ls -la 显示 ->;Windows 下 dir 看是否为“快捷方式”类型),否则你改 ../my-package/src/Helper.php,测试跑的还是旧副本。
常见失效原因:
-
repositories没写在主项目(即你正在运行phpunit的那个项目的)composer.json里,而是误写进了本地包自己的composer.json - 没配
"options": {"symlink": true},导致默认走 copy 行为 - Windows 上没开“开发者模式”或没以管理员权限运行命令行,
symlink创建静默失败 - 执行的是
composer install或composer dump-autoload,但实际需要composer update vendor/name才会重建链接
phpunit 运行时报 Class not found?检查 autoload 和 dump-autoload 时机
本地包的 composer.json 必须有合法 autoload 配置,比如:
{
"autoload": {
"psr-4": {
"MyPackage\": "src/"
}
}
}
主项目 composer.json 里不用重复声明这个映射——Composer 会自动加载 symlink 后的本地包的 autoload 规则。但注意:
立即学习“PHP免费学习笔记(深入)”;
- 改完本地包的
composer.json(比如加了新 namespace),必须在主项目里再跑一次composer dump-autoload - 如果本地包目录下没有
git init+ 至少一个 commit,Composer 会拒绝加载,phpunit就根本找不到类 - 测试文件里
use MyPackageHelper;能否解析,取决于主项目的 autoload 是否已包含该映射,而不是“本地包有没有 src/ 目录”
测试时引用的是本地代码还是 Packagist 版本?看 require 版本约束
主项目 composer.json 的 require 字段必须用 dev-main、dev-develop 这类分支名,不能写 ^1.0 或 *:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
"require": {
"myorg/my-package": "dev-main"
}
原因很直接:Composer 对 path 类型仓库只认分支名,它会忽略本地包 composer.json 里的 version 字段,只按 Git HEAD 所在分支匹配。如果本地包当前在 main 分支,但你 require 写的是 dev-develop,Composer 就会报 Could not find package——它不是找不到目录,是“找不到对应分支的包”。
验证方法:进本地包目录执行 git branch --show-current,输出必须和 require 里的分支名一致。
为什么 ./vendor/bin/phpunit 找不到本地包里的测试类?
PHPUnit 默认只扫描 tests/ 目录(或配置中 <testsuites></testsuites> 指定的路径),不会自动递归进 vendor/ 下的 symlink 包里找测试。所以本地包自己的单元测试(比如 ../my-package/tests/Unit/HelperTest.php)不会被主项目 ./vendor/bin/phpunit 自动执行。
正确做法是:
- 在主项目根目录的
phpunit.xml.dist里显式加入本地包的测试路径:<directory>../my-package/tests/Unit</directory> - 或者,在本地包内独立运行测试:
cd ../my-package && ./vendor/bin/phpunit(前提是本地包自己也装了 PHPUnit) - 不要依赖
composer install把本地包的tests/复制进vendor/——path 仓库不做复制,tests/根本不会出现在vendor/里
最易忽略的一点:本地包的 tests/ 目录结构和命名空间,必须和它自己的 autoload-dev 配置对齐;否则即使路径加对了,类也加载失败。


















