本地包未被自动加载是因 autoload 配置缺失或无效；需确保本地包 composer.json 含正确 autoload 声明，或在主项目中手动添加 autoload 映射并运行 composer dump-autoload。
本地包没被自动加载？检查 autoload 配置是否生效
Composer 默认不会自动加载本地路径包的源码，除非你在 composer.json 里明确声明了它的自动加载方式。光靠 repositories + require 只是让 Composer “知道有这个包”，不等于“能用它的类”。
- 如果本地包有
autoload字段（比如"psr-4": {"MyLib": "src/"}），它会被正常加载；但如果你只是把一个没配 autoload 的文件夹当包引入，new MyLibSomeclass()会直接报Class not found - 解决方法：进本地包目录，确保它的
composer.json里写了正确的autoload，然后在主项目中运行composer dump-autoload（不是install或update） - 临时调试时，可直接在主项目的
composer.json里加一条autoload映射，指向本地包的src/，再跑一次dump-autoload
path 类型仓库必须用绝对路径或相对于根项目的相对路径
用 repositories 声明本地包时，类型选 path 最常见，但它对路径写法很敏感——写错就完全找不到包。
- 错误写法：
"url": "./my-local-package"（以.开头，在某些 CI 环境或 symlink 场景下会失效） - 推荐写法：
"url": "packages/my-local-package"（相对路径，从主项目根目录算起）或"url": "/full/path/to/my-local-package"（绝对路径，稳定但不跨机器） - 路径末尾不能带
/，否则 Composer 可能静默忽略该仓库 - 路径下必须包含合法的
composer.json，且其中name字段要和你在require中写的完全一致（包括 vendor 名，如"myorg/mylib"）
运行 composer update 时包没更新？确认是否启用了 path 的软链接模式
默认情况下，path 类型仓库会把本地包整个复制进 vendor/，改了源码得重新 update 才生效——这反而是很多人想要“热加载”却没实现的原因。
- 想实时同步修改，要在本地包的
composer.json里加"options": {"symlink": true}，同时确保主项目composer.json的config没禁用preferred-install覆盖 - windows 下启用 symlink 需管理员权限运行终端，否则会 fallback 成 copy，还不报错
- 执行
composer update myorg/mylib（指定包名）比全量update更快，也避免误更新其他依赖
为什么 composer require 直接失败？优先检查 minimum-stability 和 prefer-stable
本地包如果没有设置 version 或只写了 dev-main 这类开发分支名，Composer 默认按稳定版约束处理，很容易卡住。
- 现象：
Could not find package myorg/mylib at any version，即使路径、name、composer.json 都对 - 原因：本地包
composer.json缺少"version"字段，或只有"branch-alias": {"dev-main": "1.0.x-dev"}，但主项目设置了"minimum-stability": "stable" - 解法一（推荐）：在主项目
composer.json的config下加"minimum-stability": "dev"，并设"prefer-stable": true保其他包稳定 - 解法二：给本地包加个明确版本号，比如
"version": "1.0.0"，并确保require里写的是"myorg/mylib": "^1.0"
本地路径依赖最麻烦的从来不是配置步骤，而是路径解析、autoload 绑定、版本稳定性三者交错出错——每次改完记得清 vendor/composer/autoload_psr4.php 缓存再试。