composer path仓库需严格配置路径、name和autoload，否则install静默跳过或class not found；url须为相对路径，启用symlink需--prefer-source或config设置，autoload须手动dump-autoload。
直接在项目里用 path 类型仓库开发私有组件，不是“加个配置就能跑”，它本质是让 Composer 把本地目录当远程包来解析——路径必须可读、结构必须合规、autoload 必须手动触发，否则 composer install 会静默跳过或报 Class not found。
path 仓库的 URL 写法和实际路径映射关系
path 类型不走 HTTP，URL 字段其实是本地文件系统路径，但写法有严格约定：
- 必须是相对路径（从当前项目根目录算起），且以
./或../开头，比如"url": "./packages/my-utils" - 不能写成绝对路径（如
/home/user/packages/my-utils），Composer 会拒绝识别 - 路径指向的必须是含合法
composer.json的目录，且该文件里name字段要和你在主项目require中写的完全一致（包括大小写、连字符） - 如果路径含空格或特殊字符，Composer 会解析失败，建议全英文+下划线
为什么 composer install 后 vendor 里没生成软链接
默认情况下，Composer 不为 path 包创建 symlink，而是复制一份到 vendor/ —— 这会导致你改源码后还得重装。要启用符号链接，必须显式开启：
- 在主项目的
composer.json根节点加："config": {"preferred-install": {"*": "source"}} - 或全局设置：
composer config -g preferred-install.source - 更直接的方式：安装时加
--prefer-source参数，composer require myorg/utils --prefer-source - 注意：即使开了
source，也只对首次安装生效；后续修改需手动rm -rf vendor/myorg/utils && composer install
autoload 不生效的三个常见断点
装进 vendor/ ≠ 类能自动加载。私有组件的 autoload 段必须由它自己声明，且主项目需重新 dump：
- 私有组件的
composer.json中必须有autoload段，例如："autoload": {"psr-4": {"MyOrg\Utils\": "src/"}} - 主项目运行
composer dump-autoload才会把私有组件的映射合并进vendor/autoload.php - 如果私有组件用了
classmap，需确保src/下有真实 PHP 文件，否则 dump 时不会收录 - 验证是否加载成功：运行
composer show myorg/utils --verbose，看输出里autoload字段是否正确，以及source路径是否指向你预期的本地目录
CI/CD 和多环境部署时 path 仓库的陷阱
path 是纯本地开发手段，上线或 CI 环境中几乎必然失效：
- GitHub Actions、Docker 构建、宝塔部署等场景，
./packages/my-utils路径根本不存在，composer install会直接报错Could not find package - 不能靠
composer config -g绕过，因为path不支持全局配置，只认项目级repositories - 安全做法：开发阶段用
path，发布前改回vcs或composer类型，并提交新composer.json - 临时规避：在 CI 脚本里先
git clone私有组件到对应路径，再跑composer install，但违背了“开发即部署”原则，维护成本高
真正稳定的私有组件协作，path 只适合单机快速验证；一旦涉及多人或交付，必须切到 vcs（Git）或自建 composer 镜像（如 Satis），否则 autoload 映射、版本锁定、CI 兼容性全是隐性雷。
