composer install 仅通过根composer.json的repositories字段识别path包，严格校验本地目录下composer.json的name与require完全一致；默认创建符号链接需满足系统支持及显式配置，修改本地代码后须运行composer update vendor/name刷新链接。

composer install 怎么识别并加载 path 仓库里的包

它不靠“扫描硬盘”或“自动发现”，而是严格按 composer.json 中 repositories 字段的声明去查找。只要配置了 "type": "path"，composer install 就会在指定路径下找一个含合法 composer.json 的目录，并校验其中的 name 是否与 require 里写的完全一致（包括 vendor 名）。

常见错误现象：Could not find a matching version of package vendor/name——不是包不存在，而是 composer.json 里没写 repositories，或者路径写错、name 拼错、本地目录根本没放 composer.json。

• url 必须指向一个**目录**，不是 composer.json 文件本身
• 该目录下的 composer.json 必须有 name 和 version（哪怕写 "dev-main"）
• 如果用了通配符如 "../packages/*"，每个匹配子目录都得有独立的 composer.json

为什么 composer install 后 vendor 里是符号链接而不是复制文件

这是默认行为，但前提是满足两个条件：操作系统支持 symlink（Linux/macOS 默认支持；Windows 需启用开发者模式或管理员权限），且本地包未被标记为 "dist" 类型。

你看到的 vendor/vendor/name 实际是指向你本地路径的软链，所以改本地代码，项目里立刻生效——这和 composer dump-autoload 无关，后者只刷新类映射，不碰链接。

Discussion Composer

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

下载

• 确认是否真链接成功：运行 ls -la vendor/vendor/name（Linux/macOS）或 dir vendor\vendor\name（Windows），输出应含 -> 或 <symlink></symlink>
• 想强制复制而非链接？在 config 里设 "preferred-install": {"vendor/name": "dist"}
• CI/CD 环境下链接必然失败，因为路径不存在——上线前必须移除 repositories 中的 path 条目

本地包改了代码，为什么 composer install 不更新链接

composer install 只重建缺失的链接，不会刷新已有链接的目标路径。它依赖 composer.lock 记录的当前解析结果，而这个结果在首次 require 或 update 时就已固化。

也就是说：改完本地包代码，composer install 什么也不做；必须运行 composer update vendor/name 才会重新解析 path、重建 symlink。

• composer update 无参数会全量重算，慢且易引入意外变更；指定包名更快、更安全
• composer require vendor/name:dev-main 第一次引入时，也触发 symlink 创建
• 别指望 composer dump-autoload 或 composer clear-cache 能解决链接问题

path 仓库在团队协作和部署中容易被忽略的关键点

最常被漏掉的不是语法，而是上下文适配：path 是开发阶段的快捷方式，不是部署方案。

一旦把含 path 的 composer.json 提交到 Git，别人 composer install 就会卡住——因为他们机器上没有那个路径，或者路径结构不同（比如 Windows 用户 vs macOS 用户）。

• 推荐做法：用 .gitignore 排除 composer.json 中的 repositories 段，或用分支隔离（如 dev-local 分支保留 path，main 分支移除）
• 绝对路径在 Windows 写成 C:/Users/xxx（正斜杠），不能用 C:\Users\xxx（反斜杠会被 JSON 解析为转义字符）
• 相对路径虽安全，但要求团队成员项目结构一致；建议约定根目录下统一放 packages/ 子目录