本地path仓库没生效，需确认repositories在composer.json顶层、url为相对路径、包名与本地composer.json中name完全一致；已有composer.lock时须删除lock和vendor后执行composer install才能生效。
本地 path 仓库没生效？先确认 composer.json 配置是否正确
常见错误是 repositories 位置放错，或类型/路径写错。它必须是项目根目录下 composer.json 的顶层字段，不能嵌在 require 或 config 里。
正确结构示例：
{
"require": {
"myvendor/mylib": "dev-main"
},
"repositories": [
{
"type": "path",
"url": "../mylib"
}
]
}
注意点：
-
url值必须是相对路径（如../mylib），不能以/开头，否则 Windows 下会解析失败 -
myvendor/mylib必须与本地mylib/composer.json中的"name"完全一致（包括大小写） - 本地库的
composer.json中建议设"minimum-stability": "dev"和"prefer-stable": false，否则可能因稳定性约束被跳过
为什么 composer install 还是从 Packagist 下载？
Composer 默认只在首次安装或锁文件缺失时读取 repositories；如果已有 composer.lock，它会照着锁文件还原，完全忽略新配置的 path 仓库。
必须执行以下操作才能强制切换：
- 删掉
composer.lock - 删掉
vendor/目录（不删的话旧包残留，autoload 仍指向原位置） - 运行
composer install（不是update）——因为install会重新解析composer.json并生成新锁文件
如果只想重装某个包，可用 composer remove myvendor/mylib && composer require myvendor/mylib，但前提是 repositories 已存在且生效。
path 仓库下修改代码不生效？检查软链接和 autoload
Composer 对 type: "path" 的处理方式是：创建 vendor/myvendor/mylib 到本地目录的符号链接（Linux/macOS）或目录交接（Windows）。但这个链接不会自动更新。
常见问题：
- 改了本地库代码，但主项目运行时没变化 → 检查
vendor/myvendor/mylib是否仍是真实目录（而非链接），若是，说明上次install没走path流程 - autoload 找不到新类 → 运行
composer dump-autoload（仅刷新自动加载映射，不重装包） - 本地库加了新文件但未被加载 → 确保其
composer.json的"autoload"字段已声明对应规则（如"psr-4"映射），然后再次dump-autoload
想临时禁用 path 仓库，又不想删配置？
不需要注释或删除 repositories。Composer 提供运行时开关：
加 --no-plugins 不起作用；真正有效的是：
-
composer install --ignore-platform-reqs无关 - 正确做法：用环境变量临时屏蔽 ——
COMPOSER_DISABLE_PATH_REPOSITORIES=1 composer install - 或者更直接：把
"repositories"数组暂时改成空数组[]，再install，完事再改回来（适合 CI 或批量操作）
注意：path 仓库一旦启用，就绕过了版本校验和 Packagist 缓存，所有依赖解析都基于本地文件状态——这点容易被忽略，尤其在团队协作中，别人拉代码后若没同步本地库路径，composer install 会直接失败。
