Composer怎么配置本地包调试开发环境-composer-PHP中文网

必须用path类型仓库、以./或../开头的相对路径、本地包含合法composer.json，否则composer静默跳过；name须与require逐字一致，symlink需在本地包composer.json中声明"options":{"symlink":true}，autoload更新须执行composer dump-autoload -o。

composer怎么配置本地包调试开发环境

必须用 path 类型仓库 + 正确相对路径 + 本地包含合法 composer.json，否则 Composer 静默跳过，不报错也不装包。

path 仓库的 url 必须以 ./ 或 ../ 开头

Composer 只认以 ./ 或 ../ 开头的相对路径，不解析 ~、$HOME、绝对路径或 file://。写错就等于没配。

"url": "packages/my-utils" ❌ 缺 ./ 前缀，被忽略
"url": "/home/user/pkg" ❌ 绝对路径，静默跳过
"url": "~/pkg" ❌ 波浪号不展开，无效
"url": "../my-local-package" ✅ 上级目录，合法
"url": "./packages/utils" ✅ 同级子目录，合法

Windows 下同样适用，不用盘符，"url": "../my-lib" 就行。

本地包的 `composer.json` 必须满足三项硬性条件

主项目能识别本地包，前提是本地包自己“够格”——不是放个文件夹就行。

name 字段必须和你在主项目 require 中写的**逐字一致**：大小写、分隔符（只允许短横线 -）、vendor 名全部匹配，比如 "acme/utils" ≠ "acme/utils-dev"
根目录下必须有语法合法的 composer.json（无尾逗号、全双引号、JSON 有效）
目录需已执行 git init 并至少有一个 commit；没有 git 仓库，Composer 直接拒绝识别

常见现象：Could not find package acme/utils，但 composer show --all 里压根没它——八成是 name 不一致或本地包没 git init。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

symlink 没生效？问题大概率出在本地包自己的 `composer.json`

path 仓库默认尝试创建符号链接，失败则静默 fallback 到复制（copy），结果你改源码，vendor/ 里还是旧副本。

关键配置不在主项目，而在**本地包自己的 composer.json 中**："options": {"symlink": true}
Windows 用户必须以管理员身份运行终端，否则 symlink 创建失败且无提示
Docker 场景需加 --cap-add=SYS_ADMIN，并确保挂载方式支持 symlink
验证是否真用了 symlink：ls -la vendor/acme/utils（Linux/macOS）看到箭头，或 dir vendor\acme\utils（Windows）看到 JUNCTION 才算成功

如果显示为普通文件夹，说明 fallback 成 copy，立刻检查本地包有没有漏掉 options 段。

autoload 不生效？不是没装，是映射没刷进去

即使 path 仓库成功加载了包，类仍可能 Class not found——因为自动加载规则没进 vendor 的 autoload 文件。

本地包的 autoload（如 psr-4）只定义映射关系，不会自动注入到主项目的 autoloader
必须在主项目执行：composer dump-autoload -o（优化模式）或 composer dump-autoload --optimize
仅 composer dump-autoload 不处理 autoload 规则，必须带 -o 或 --dev（视 autoload-dev 是否启用）
验证方法：打开 vendor/composer/autoload_psr4.php，搜索你的命名空间，看是否存在对应路径映射