如何配置Composer本地包引用路径-composer-PHP中文网

必须在主项目composer.json的repositories数组中严格配置path源，确保本地包name、路径、版本三者完全对齐，否则composer无法发现包；repositories必须位于根级，url指向含合法composer.json的目录，name大小写及分隔符须逐字匹配，版本用dev-main并需git commit，symlink开关须设于本地包composer.json内。

如何配置composer本地包引用路径

必须在主项目 composer.json 的 repositories 数组里写死路径、包名、版本三者对齐，否则 composer require 会直接报 “Could not find package” —— 不是网络问题，是根本没被扫描到。

repositories 必须写在主项目根 `composer.json` 顶层

本地包自己的 composer.json 里写 repositories 完全无效。Composer 只读主项目的配置，且只在根级 repositories 数组里找源。

正确写法："repositories": [{ "type": "path", "url": "./packages/my-utils" }]
错误写法：把整个 repositories 块塞进 config、extra 或本地包的 composer.json 里
url 必须指向一个**目录**（不是 composer.json 文件），该目录下必须存在合法的 composer.json
末尾不能加 /，"./packages/my-utils/" 会被静默忽略

`name` 字段大小写与分隔符必须逐字匹配

Composer 不做模糊匹配，acme/utils 和 Acme/Utils、acme_utils、acme-utils 全部不等价。

Discussion Composer

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

下载

本地包 composer.json 中的 name 必须是 vendor/name 格式，仅含小写字母、短横线 -，斜杠为唯一分隔符
require 里写的字符串必须完全一致，包括大小写和所有字符
常见坑：name 写了 "myorg/my-lib"，但 require 里写成 "myorg/my_lib" 或 "MyOrg/my-lib"，均失败

用 `dev-main` 而不是 `1.0.0` 作为版本约束

path 类型仓库下，Composer 忽略本地包 composer.json 中的 version 字段，只按 Git 分支名解析。没打 tag 就别写稳定版号。

本地包需已执行 git init && git add . && git commit -m "init"，否则 Composer 直接跳过该目录
推荐 version 字段设为 "dev-main"（Git 2.27+ 默认分支）或 "dev-develop"
require 行对应写 "myorg/my-lib": "dev-main"；若项目设了 "minimum-stability": "dev"，还需加 @dev 后缀："myorg/my-lib": "dev-main@dev"
composer install 不触发仓库识别，必须用 composer require myorg/my-lib:dev-main 或 composer update myorg/my-lib

符号链接默认启用但 Windows/Docker 需显式干预

path 仓库默认尝试创建 symlink，失败则静默 fallback 到 copy 模式——这时改本地代码，vendor/ 下完全没反应。

关键开关不在主项目配，而在**本地包自己的 composer.json** 里加："options": {"symlink": true}
Windows 用户必须以管理员身份运行终端，否则 symlink 创建失败且无提示
Docker 场景需启动容器时加 --cap-add=SYS_ADMIN，并确认挂载方式支持 symlink
验证是否生效：ls -la vendor/myorg/my-lib（Linux/macOS）应显示 ->；Windows 用 dir vendor\myorg\my-lib 看是否为“快捷方式”类型

最常被忽略的是：本地包目录必须有 Git commit，且 symlink 开关必须写在本地包自己的 composer.json 里——这两点不满足，其他配置全对也白搭。