根本原因在于composer只从repositories数组查找源，require仅声明需求；本地path源必须正确配置在主项目composer.json中，含合法composer.json、git初始化、symlink选项及autoload更新。
直接配 repositories，别往 require 里塞路径——这是唯一能走通的路。
为什么 composer require vendor/name:dev-main 总报 “Could not find package”
根本不是网络或缓存问题，而是 Composer 根本没“看见”你的本地目录。它只从 repositories 数组里找源，require 字段只声明“我要谁”，不负责“去哪找”。常见断点：
-
repositories没写在主项目（即你正在cd进去的那个目录）的composer.json根级，而是错放在本地包自己的composer.json里 -
url写了绝对路径（如/home/user/pkg或C:my-pkg），Windows 下尤其容易静默失败（盘符、空格、反斜杠全会中断） - 本地包目录下没有合法
composer.json，或者里面缺name字段，或大小写和require里写的不一致（acme/utils≠Acme/Utils） - 本地包没运行过
git init && git add . && git commit -m "init"，Composer 会跳过未初始化的 Git 目录
怎么让改完本地代码立刻在主项目生效
默认行为是复制（copy），不是链接（symlink）。你改了 ../my-package/src/Helper.php，vendor/acme/utils/Helper.php 还是旧文件。必须显式启用符号链接：
- 在主项目
composer.json的repositories条目里加"options": {"symlink": true} - 执行
composer update acme/utils（不是dump-autoload，也不是全量update） - 验证：Linux/macOS 下
ls -la vendor/acme/utils应显示->箭头；Windows 下用dir vendorcmeutils看是否为“快捷方式”类型 - Windows 用户需开启“开发者模式”或以管理员权限运行命令行，否则
symlink创建失败且无提示
path 仓库和远程仓库的关键区别在哪
不在“能不能装上”，而在“怎么装、怎么更新、怎么维护”。path 类型跳过所有元数据请求（不连 Packagist、不查 packages.json），直接读取本地 composer.json 内容，因此它天然离线、极快，但也更脆弱：
- 不支持
composer install自动发现：必须先require，再update，否则vendor里什么都不会有 - 忽略
version字段：只认当前 Git HEAD 所在分支，所以require必须写dev-main、dev-develop，不能写1.0.0 - 本地包的
autoload配置必须正确（如"psr-4": {"MyPackage\": "src/"}），否则Class not found和 Composer 无关，而是自动加载器没注册到命名空间 - 如果本地包要被 Laravel 使用，
ServiceProvider或Facade仍需手动在config/app.php中注册——Composer 不处理这部分
最常被忽略的是：本地包改了 autoload 映射或新增了类，必须在主项目里跑一次 composer dump-autoload，否则新命名空间不会进自动加载器。这一步和 symlink 无关，但缺了就直接报错。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
