Composer Monorepo 管理核心是用 path 类型仓库将本地子目录注册为合法包源；需在根 composer.json 的 repositories 中声明路径，子包含正确 name 和 autoload，且 require 名称须完全一致。
Composer 做 Monorepo 管理，核心不是“改工具”，而是用 path 类型仓库把本地子目录“注册”成合法包源——只要配置对，composer require 就能直接软链接到源码，改完即生效。
为什么 composer require myorg/utils 装不上本地包？
最常见原因是 Composer 根本没“看见”你的子包目录。它默认只查 Packagist，不会自动扫描 packages/ 下的文件夹。
-
repositories必须写在根目录的composer.json里，不能写在子包自己的文件中 -
url是相对于根目录的路径，比如子包在packages/utils，就得写"packages/utils"或通配"packages/*"（注意：**不支持） - 每个匹配目录下必须有有效的
composer.json，且含"name"字段，例如"myorg/utils"—— 这个值必须和require里写的完全一致，大小写、斜杠方向都不能错 - 版本约束别混用：
"*"、"*@dev"、"dev-main"都行；但别写"^1.0"，否则 Composer 会优先选 Packagist 上已发布的 1.x 版本，跳过本地 - 改完
repositories或子包composer.json后，先跑composer clear-cache，否则可能读缓存导致识别失败
符号链接没创建，vendor/myorg/utils 是复制出来的？
这是 Windows 权限或 Linux 文件系统挂载选项导致的退化行为，不是配置错误。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- Windows 用户需确认终端是否以管理员身份运行，或已启用“开发者模式”（否则
mklink被禁用） - Linux/macOS 上检查
vendor/所在分区是否挂载了noexec或nosymfollow - 可在
repositories条目里显式加"options": {"symlink": true}，强制启用符号链接（2026 年主流 Composer 版本均支持） - 别用绝对路径写
url，协作时别人机器上路径不同，url会直接失效
子包之间互相依赖，怎么让 user-service 正确加载 data-validator？
链式依赖在 Monorepo 里很常见，但容易漏配——关键在于所有被依赖的子包，都必须落在 repositories 的 url 覆盖范围内。
- 别只配一条
"packages/*"就以为万事大吉：如果data-validator在packages/core/data-validator，那"packages/*"不会匹配它（通配只支持一层） - 推荐统一用多条
path条目："packages/*"+"packages/core/*"+"apps/*"，或直接调整目录结构保持扁平 - 子包
composer.json中的"autoload"必须正确映射命名空间，比如"MyOrg\DataValidator\": "src/"，否则即使链接成功，类也加载不到 - 若子包依赖另一个子包，它自己的
require也要写全限定名，例如"myorg/core-utils": "dev-main"，且该包也得在repositories中可被发现
真正容易被忽略的点是：Monorepo 里没有“全局自动发现”，每个路径、每个 name、每个 symlink 行为，都是你手动声明的结果。少一个 repositories 条目，或一个大小写不一致，整个依赖链就断在本地。别指望 Composer 自己猜。
