path仓库需在composer.json中用绝对路径配置repositories，require版本须与本地包version一致或为dev-main，且name严格匹配；上线前必须移除，仅限开发使用。
composer.json 里怎么写 path 类型仓库
本地开发时想边改包边用，不能每次改完都 push + packagist 同步，path 仓库是唯一靠谱的方案。它让 Composer 直接从你本机某个目录加载包，连 git 都不用初始化。
常见错误是只加了 repositories 却漏掉 require 的版本约束，或者路径写成相对路径（Composer 只认绝对路径或以 ./ 开头的相对路径，但推荐绝对路径防错）。
- 在项目根目录的
composer.json里加repositories块，类型必须是path，url填本地包的绝对路径，比如/Users/me/my-package -
require里照常写包名和版本号，但这个版本号必须和你本地包的composer.json里version字段一致，或设为"dev-main"/"dev-master"（取决于你本地分支名） - 本地包的
composer.json必须有name字段，且和require里的名字完全一致，大小写都不能错
运行 composer require 时为什么报 “could not find package”
不是网络问题，也不是包名打错——大概率是 repositories 没生效，或者版本不匹配。
Composer 默认只查 packagist.org，你加的 path 仓库不会自动覆盖全局源。它只对当前项目有效，而且只在 composer install 或 composer update 时读取；composer require 默认不触发仓库重载，所以会直接去线上找。
- 先手动删掉
vendor/和composer.lock（如果已有） - 确保
composer.json已保存最新配置 - 运行
composer update vendor/package-name，而不是require—— 这样才会强制走你配的path源 - 如果还是找不到，用
composer config --list | grep repositories看仓库是否被正确读入
本地包改了代码，为什么 vendor 里没更新
因为 path 类型仓库默认启用 symlink（符号链接），不是拷贝。改本地代码，vendor 下对应目录的内容应该实时变化——但前提是你的系统和 Composer 版本支持 symlinks。
Windows 上默认禁用 symlink（尤其老版本 Git Bash 或 CMD），macOS/Linux 一般没问题。另外，如果你之前用 composer install 装过非 path 版本，Composer 可能缓存了旧行为。
- 检查
composer.json里repositories的options是否显式关掉了symlinks（比如写了"symlinks": false） - 运行
composer update --no-cache vendor/package-name强制刷新 - 确认
vendor/package-name是个软链接：macOS/Linux 用ls -l，Windows 用dir看有没有<symlinkd></symlinkd>标识
上线部署时 path 仓库还能用吗
不能。生产环境服务器上那个本地路径根本不存在，composer install 会直接失败。
很多人误以为只要把本地包一起传到服务器就行，但 Composer 不会自动识别“哦这是 path 包，我该从哪读”。它只认配置，而配置里写的还是你开发机的绝对路径。
- 上线前必须删掉
repositories块，改用正规发布流程：打 tag、push 到私有 Git 服务器、配私有 Packagist 或 Satis - 或者用
composer config --unset repositories在 CI 脚本里临时清掉 - 更稳妥的做法：把
path仓库定义放在composer.json的config里，用COMPOSER_HOME或环境变量控制是否启用，但实际很少这么搞，容易混淆
path 仓库只适合开发阶段快速验证，跨环境就失效。别想着“先本地跑通再上线”，得从一开始就想好包怎么发布。
