Composer如何在开发环境引用本地扩展包-composer-PHP中文网

composer require vendor/name:dev-main 报“could not find package”是因为 repositories 未在主项目 composer.json 根级配置、路径非相对、本地包无有效 composer.json 或 git 初始化，且需执行 composer update 启用 symlink 并确保 autoload 正确注册。

composer如何在开发环境引用本地扩展包

为什么`composer require vendor/name:dev-main`总报“Could not find package”

根本不是网络或缓存问题，而是 Composer 根本没“看见”你的本地目录。它只从主项目 composer.json 的 repositories 数组里找源，require 字段只声明“我要谁”，不负责“去哪找”。常见失效原因：

repositories 写在了本地包自己的 composer.json 里，而不是主项目的根级配置中
url 用了绝对路径（如 C:/work/my-pkg 或 /home/user/pkg），Windows 下极易静默失败；必须用相对路径（如 "../my-pkg" 或 "./packages/utils"）
本地包目录下没有 composer.json，或有但 name 字段拼错、大小写不一致（比如写了 "acme/utils" 却在 require 里写 "Acme/utils"）
本地包的 composer.json 没执行过 git init 或至少一个 commit，Composer 会跳过该目录

怎么配 `repositories` 才算生效

必须满足三要素对齐：配置位置、包名、版本写法。缺一不可。

配置必须写在主项目根目录 composer.json 的根级 repositories 数组里，不能塞进 require、config 或其他字段
type 必须是 "path"，不是 "package" 或 "vcs"
url 是相对于当前 composer.json 的路径，例如 "./packages/my-utils"；禁用 file://、~/、环境变量等写法
整个 repositories 是 JSON 数组，哪怕只加一个也要写成 [{ "type": "path", "url": "./packages/my-utils" }]
本地包的 composer.json 中 name 字段（如 "acme/utils"）必须与 require 中完全一致（大小写敏感）
版本约束必须用 dev-main、dev-develop 这类分支名，不能写 1.0.0 —— path 源下 Composer 忽略 version 字段，只认当前 Git HEAD 所在分支

改完本地包代码，为什么主项目里没生效

默认行为是复制（copy），不是符号链接（symlink）。你改了 ../my-pkg/src/Helper.php，vendor/acme/utils/Helper.php 还是旧文件。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

启用 symlink：在主项目 composer.json 的对应 repositories 条目里加 "options": {"symlink": true}（Linux/macOS 默认开启，但 Windows 必须显式写）
必须执行 composer update acme/utils（不是 install，也不是 dump-autoload），才会重建链接
验证是否成功：ls -la vendor/acme/utils 应显示 -> 指向源目录；Windows 下用 dir vendorcmeutils 查看是否为“快捷方式”类型
Windows 用户需开启“开发者模式”或以管理员权限运行命令行，否则 symlink 创建会失败且无提示

`Class not found` 是不是 path 配置错了

90% 不是 path 问题，而是自动加载没注册。

确认本地包的 composer.json 里有正确的 autoload 配置，例如："psr-4": {"Acme\Utils\": "src/"}
运行 composer dump-autoload（开发阶段不用加 -o），否则新命名空间不会注册进自动加载器
如果包提供了 Laravel ServiceProvider 或 Facade，必须手动在 config/app.php 的 providers 或 aliases 里注册 —— Composer 不处理这部分
别在 require 'vendor/autoload.php' 之前就实例化类，也别用相对路径引入 autoload 文件