本地包路径优先级不由repositories数组顺序决定，而由type类型和匹配逻辑硬性控制：type:"vcs"需Git仓库且URL指向含composer.json的合法Git地址，type:"path"才支持本地文件系统路径，且url必须以./或../开头、包名与require完全一致，否则静默失效。
本地包路径优先级不靠“顺序”决定，而靠 repositories 类型和匹配逻辑硬性控制——VCS 仓库必须置顶、URL 必须指向含 composer.json 的 Git 目录、且包名和版本必须完全对齐，否则根本不会被识别。
为什么 repositories 里放最前面也不生效？
常见错误是把本地路径当普通文件夹用，而 Composer 对 type: "vcs" 仓库只做一件事：按需克隆 Git 仓库。它不扫描目录、不解析相对路径、不 fallback 到本地文件系统。
-
url值必须是合法 Git 仓库地址（如"https://git.internal/myorg/utils"或"../utils"），不能是"./utils"（缺上级路径）或"utils/"（无协议也无../） - 本地目录必须已执行
git init且至少有一个 commit；空目录或未初始化的 Git 仓库会被静默跳过 - 若该仓库没打任何 tag，
require中写"myorg/utils": "1.2.0"会失败——只能用"dev-main"这类分支别名，且主项目需设"minimum-stability": "dev" -
name字段在本地包的composer.json中必须和require里写的字符串逐字一致："myorg/utils"≠"MyOrg/utils"≠"utils"
type: "path" 和 type: "vcs" 的本质区别
type: "path" 是唯一真正支持“本地文件系统路径”的类型，但它不参与元数据合并，只在 require 显式命中时触发，并且路径必须以 ./ 或 ../ 开头。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"type": "path", "url": "../my-package"✅ 可用，Composer 会直接 symlink（启用"symlink": true时）或 copy -
"type": "path", "url": "/home/user/pkg"❌ 静默失败，绝对路径不被解析 -
"type": "path", "url": "my-package"❌ 缺少./或../，不被视为有效路径 -
type: "vcs"走 Git 协议，适合长期维护的私有组件；type: "path"适合快速调试，但每次改代码后需手动运行composer dump-autoload刷新自动加载
如何验证本地包是否真被加载？
别只看 composer install 输出是否“成功”，要确认三点：实际安装来源、自动加载路径、符号链接状态。
- 加
-vvv运行composer require myorg/utils，观察日志中是否出现Installing myorg/utils (dev-main): Symlinking from ../my-package - 检查
vendor/myorg/utils是否为符号链接（Linux/macOS）或 junction（Windows）；若只是复制的副本，说明"symlink": true未生效或系统不支持 - 运行
composer config --list | grep repositories，确认你配置的type: "path"或type: "vcs"仓库确实在生效配置中，没被项目级或全局配置覆盖 - 若用
type: "path"，确保主项目composer.json中没意外禁用 symlink（如"config": {"symlink": false}）
最容易被忽略的是：本地包的 composer.json 修改后，不会自动触发重安装——必须删掉 vendor/myorg/utils 再跑一次 composer install 或 composer update myorg/utils，否则旧缓存和 autoload 映射依然存在。
