因为Composer默认只在install或首次require时读取path源，后续update不感知本地代码变更；需手动执行composer update vendor/package --with-dependencies，并确保url为绝对路径或以../开头的相对路径，且本地包name与require完全一致。
用 path repository 调试本地依赖时，为什么包没更新？
因为 Composer 默认只在 composer install 或首次 composer require 时读取 path 源，后续 composer update 不会自动拉取你本地代码的变更——它只认 composer.lock 里锁定的提交哈希（哪怕你改了 path 目录下的代码）。
实操建议：
- 每次修改本地依赖后，必须运行
composer update vendor/package-name --with-dependencies，强制重解析该包及其子依赖 - 确保
composer.json中的path值是**绝对路径**或以../开头的相对路径（不能是./），否则 Composer 会忽略它 - 检查你的本地包根目录下是否有
composer.json，且其中name字段必须与主项目require的完全一致（包括大小写）
path repository 配置写法和常见错误
必须在主项目的 composer.json 根级加 repositories 块，类型为 path，不是 vcs。
正确示例：
{
"repositories": [
{
"type": "path",
"url": "../my-local-package"
}
],
"require": {
"vendor/my-local-package": "*"
}
}
容易踩的坑：
-
url值指向的目录里没有有效的composer.json→ 报错Could not find package vendor/my-local-package at any version - 写了
"type": "vcs"却把url指向本地文件夹 → Composer 尝试走 Git 协议，报Failed to clone ... does not appear to be a git repository - 本地包
composer.json中version字段写死了（如"version": "1.0.0"），会导致 Composer 认为它是稳定版，跳过dev-main等分支匹配 → 改成"version": "dev-main"或直接删掉version
调试时如何确认 Composer 正在用 path 而不是 packagist
执行 composer show vendor/package-name，看输出里的 source 行：
- 如果是
type : path+ 本地路径，说明生效 - 如果显示
type : git和远程 URL，说明repositories配置未命中，或包名/版本约束不匹配
更直接的办法：临时在本地包的 composer.json 里改个字段（比如加一行 "test-timestamp": 123456789），然后运行 composer update 并立刻 composer show，如果新字段出现在输出里，就证明走的是本地 path。
注意：composer dump-autoload 不影响 path 解析，别指望靠它刷新依赖来源。
path 替代 vcs 后，CI/部署怎么处理？
CI 环境通常没有你的本地路径，path 仓库会直接失效。不能靠注释掉再切回 vcs——这容易漏同步、引发环境不一致。
推荐做法：
- 开发时用
path，但 CI 用独立的composer.json变体（例如composer.ci.json），通过COMPOSER=composer.ci.json composer install切换 - 或者用
config.platform+ 环境变量组合：在 CI 中设COMPOSER_PATH_REPOS=0，并在repositories里用packagist.org回退逻辑（需 Composer 2.2+） - 最稳妥的是：本地调试完，立刻
git commit到真实仓库，再composer require vendor/package:dev-main#commit-hash锁定，避免 path 配置污染生产流程
很多人卡在“以为切了 path 就万事大吉”，其实本地改完不提交、不锁 commit，上线一跑就挂——path 是纯开发快捷键，不是部署方案。
