Composer报“Could not find package”主因是repositories未置于composer.json根级、path路径错误、本地包name/version不匹配或未显式指定版本；需确保autoload正确配置并运行dump-autoload验证。
直接用 path 类型仓库，其他方式（如手动拷贝、require 本地路径、全局 install）都会导致 autoload 失效或改代码不生效。
为什么 composer require vendor/name 总报 “Could not find package”
90% 是配置没落在正确位置或路径/名称不匹配：
-
repositories必须写在主项目composer.json的根级，和require同级，不能塞进extra或autoload里 -
url必须以./或../开头，不支持~、$HOME、绝对路径、file:// - 本地包根目录下必须有合法
composer.json，且其中"name"字段（如"hoo/tool"）必须和主项目require中的字符串逐字一致：大小写、斜杠、短横线都不能错 - 本地包目录需已执行
git init并至少有一个commit，否则 Composer 拒绝识别（Windows/Docker 尤其敏感）
vendor/name 目录存在但类找不到、改代码不生效
不是 Composer 没装上，而是 symlink 没真正启用，或 autoload 映射没更新：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 检查是否真用了符号链接：
readlink vendor/hoo/tool（Linux/macOS）或dir vendor\hoo\tool（Windows），看到->或JUNCTION才算成功；若只是普通文件夹，说明 fallback 到了 copy 模式 - 本地包自己的
composer.json必须声明"options": {"symlink": true}，仅主项目配"symlinks": true不起作用 - Windows 下需管理员权限运行终端；Docker 需加
--cap-add=SYS_ADMIN并确认挂载支持 symlink - 改完本地包的
autoload或autoload-dev后，必须手动运行composer dump-autoload --dev，否则映射不会写入vendor/composer/autoload_dev.php
怎么写 require 才能立刻生效、不用反复 update
关键不是版本号本身，而是让 Composer 明确跳过 Packagist 并锁定本地源：
立即学习“PHP免费学习笔记（深入）”；
- 推荐用
@dev：执行composer require hoo/tool:@dev，前提是主项目已设"minimum-stability": "dev" - 若本地包在
main分支，可设"version": "dev-main"，然后composer require hoo/tool:dev-main；切分支后git checkout feat/x，项目里立即生效，无需composer update - 别写
composer require hoo/tool（无版本），Composer 会按默认稳定性策略去“猜”，而本地包通常不满足stable要求，直接失败 - 删掉本地包目录后，
composer install会静默跳过该包——这比报错更难察觉，适合临时关闭调试
最易被忽略的是本地包自身 composer.json 里的 "options": {"symlink": true} 和 Windows 权限问题：缺它，即使路径全对、Git 初始化了，也会 fallback 到 copy 模式，改完代码却始终加载旧副本。
