答案：加了path仓库仍报Could not find package，根本原因是Composer未识别本地包，需同时满足三个硬性条件：项目composer.json根级声明"type": "path"仓库；本地包目录下有合法composer.json且name字段与require完全一致（大小写敏感）；本地包已git init并至少一个commit。
为什么加了path仓库还是报Could not find package
这不是网络问题，而是Composer根本没“看到”你的本地包。常见原因有三个：name字段不一致、url路径无效、或项目级repositories配置没写对位置。
-
name必须和composer require时写的**完全一致**（大小写敏感），比如本地包composer.json里是"acme/utils"，你就不能写composer require Acme/utils -
url必须是相对于项目根目录的路径，Linux/macOS用"./packages/my-utils"，Windows必须带盘符如"C:/dev/my-utils"，不能用file://或绝对路径/home/xxx -
repositories必须写在项目composer.json的**根级**，不是嵌套在require或config里；且必须是数组：[{"type":"path","url":"./packages/my-utils"}]
path仓库require时为什么必须加@dev
因为Composer默认只认稳定版本（stable），而本地目录没有tag，只有dev-main或dev-develop这类开发分支。不加@dev，它会直接过滤掉本地包，连路径都不去查。
- 执行
composer require acme/utils:dev-main，不是composer require acme/utils - 如果想省略版本后缀，得在项目
composer.json里显式设"minimum-stability": "dev"，但不推荐——容易污染生产环境依赖策略 - 本地包目录下必须已运行
git init并至少有一个commit，否则Composer拒绝识别该路径为有效源
怎么确认Composer真的没发HTTP请求
光看有没有报错不够，得验证日志里是否出现任何Downloading或repo.packagist.org字样。关键操作是三重保险：
- 全局禁用：
composer config --global repo.packagist false - 检查项目级配置：
composer config repo.packagist输出应为空；若非空，删掉composer.json中repositories里所有指向https://packagist.org的条目 - 执行时加环境变量：
COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader——--no-plugins不是可选，插件（如phpstan/extension-installer）可能偷偷联网
装上了但Class not found怎么办
90%不是Composer配置问题，而是autoload没生效或框架没注册。先排除这三点：
- 确认本地包
composer.json里写了正确的autoload，比如"psr-4": {"Acme\Utils\": "src/"} - 运行
composer dump-autoload（不用-o），否则新命名空间不会写入vendor/autoload.php - 如果包提供Laravel服务，必须手动在
config/app.php的providers里加对应ServiceProvider——Composer不处理这部分
真正容易被忽略的是：path仓库在CI或部署机上基本不可用——路径不存在、权限不足、Git未初始化，都会导致静默失败。离线部署务必用artifact或--no-network + cache-dir方案，而不是依赖path。
