本地包路径别名本质是name字段映射，不是路径重命名；require包名必须与本地包composer.json中name字段逐字一致（含大小写、短横线、斜杠），url须为相对于主项目composer.json的有效路径且不带尾斜杠。

本地包路径别名本质是 name 字段映射，不是路径重命名

Composer 没有“路径别名”这个概念。所谓“别名”，实际是你在主项目 composer.json 的 require 中写的包名（如 "myorg/utils"），必须和本地包目录里 composer.json 中的 name 字段**完全一致**——包括大小写、连字符、斜杠方向。它不是路径的别名，而是包的身份标识。

如果你希望用 myorg/utils 引入一个放在 ./packages/core-lib 下的本地代码，那就必须确保该目录下的 composer.json 里写着："name": "myorg/utils"。否则 composer require myorg/utils 会直接报 Could not find package，哪怕路径完全正确。

• 本地包 composer.json 缺 name 或拼写错误 → Composer 静默跳过该 path 仓库，不提示也不报错
• 主项目 require 写了 "myorg/utils": "*"，但本地包 name 是 "myorg/utils-dev" → 找不到，不是缓存问题，是身份不匹配
• 想临时覆盖 Packagist 上的同名包？只要 repositories 里声明了对应 name 的 path 类型仓库，Composer 就自动优先走本地路径，无需额外开关

path 类型仓库的 url 不是别名，而是相对路径定位器

url 字段的作用，是告诉 Composer “去哪找这个包的 composer.json”。它必须是相对于主项目根目录 composer.json 的**有效相对路径**，且结尾不能带斜杠（"./packages/my-utils/" 会失败）。

常见错误：把 url 写成 "file:///home/user/project/packages/my-utils" 或 "/absolute/path" —— 这些在 CI、Docker 或其他协作环境中大概率静默失效，因为路径不可移植。

Discussion Composer

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

下载

• 正确写法："url": "../my-local-package" 或 "url": "./packages/utils"
• 路径指向空目录或不存在的目录 → Composer 不报错，但后续 composer install 会跳过该仓库
• 路径下没有合法 composer.json（语法错误、缺 name、缺 autoload）→ 同样静默跳过，不会触发自动加载注册

为什么 vendor 目录里看不到包名，却能看到路径符号链接？

执行 composer install 后，Composer 默认会在 vendor/ 下创建一个**符号链接**（Linux/macOS）或**硬链接**（Windows），指向你配置的 url 路径。所以你在 vendor/myorg/utils 看到的不是一个复制的副本，而是一个指针。

这意味着：改本地包 src/ 里的代码，主项目立刻生效；但同时也意味着，如果本地路径被移动、重命名或权限变更，运行时就会抛出 Class not found 或 failed to open stream 错误——这和 autoload 无关，是链接断裂。

• 启用软链接需本地包 composer.json 显式声明："options": {"symlink": true}（仅对 composer update 生效）
• 不加 options 时，Windows 默认硬链接，Linux/macOS 默认软链接；行为差异会导致跨平台开发时表现不一致
• CI 构建中若禁用符号链接（如某些 Docker 容器），需提前设 COMPOSER_DISABLE_NETWORK=1 并确保本地路径可访问，否则安装阶段就失败

config.vendor-dir 改变的是安装位置，不是别名逻辑

有人误以为改 config.vendor-dir 能实现“路径别名”，其实它只控制所有依赖（包括本地 path 包）最终链接到哪。比如设为 "libs"，那 vendor/myorg/utils 就变成 libs/myorg/utils，但 require 里的包名、repositories.url 的路径、本地包 name 全都不受影响。

这个配置生效前必须删掉旧 vendor 目录，且所有 PHP 代码里 require 'vendor/autoload.php' 必须同步改成 require 'libs/autoload.php' —— IDE、CI 脚本、测试启动器全得手动更新，漏一处就 Class not found。

• config.vendor-dir 值必须是相对路径（如 "dependencies"），不能以 / 开头，也不能含环境变量
• COMPOSER_VENDOR_DIR 环境变量在 Composer 2.x 中已废弃，设了也无效
• 改完后 composer dump-autoload 生成的映射文件会自动落在新路径，但自动加载器本身不感知“别名”，只认 psr-4 规则和文件系统结构

真正容易被忽略的点是：整个机制依赖三者严格对齐——主项目 require 的包名、本地包 composer.json 的 name、repositories.url 指向的路径。少一个条件，就不是“别名失效”，而是整个加载链路从第一步就断掉，且 Composer 很少给出明确提示。