Composer path仓库本质是软链接式开发，需绝对路径、name严格匹配、禁用packagist.org，三步缺一不可，否则静默跳过导致报错。

Composer 用 path 仓库加载本地包，本质是“软链接式开发”

不是真安装，而是让 Composer 把你本地目录当成一个可安装的包源——改代码立刻生效，不用反复 composer update 或发布新版本。但前提是路径必须绝对、包名必须严格匹配 name 字段，否则直接报错。

常见错误现象：Could not find package xxx at any version 或 Package xxx is not installed，多数因为 composer.json 里写的 name 和 require 里的不一致，或路径没写对。

• path 仓库只支持本地绝对路径（Windows 下也得是 C:/xxx 或 /c/xxx 格式，不能用 ~/）
• 被引用的本地包，其 composer.json 中的 name 必须和你项目 require 的完全一致（包括大小写、vendor 名）
• 若本地包有 autoload 配置，要确保它能被主项目正确加载；否则类找不到，不是路径问题，是自动加载没配好

怎么配置 path 仓库：三步缺一不可

不是加个 repositories 就完事。Composer 默认不查本地路径，得手动告诉它“这里有个包”，再显式要求安装它，最后还得关掉 Packagist 的干扰。

Discussion Composer

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

下载

• 在项目根目录 composer.json 中添加 repositories 块，类型设为 path，url 填绝对路径：

  "repositories": [
    {
      "type": "path",
      "url": "/Users/me/my-package"
    }
  ]

• require 里写明要装的包名和版本号，版本必须是 * 或 dev-main（取决于本地包的默认分支），不能写 1.0.0 —— path 仓库不走版本解析逻辑
• 加上 "packagist.org": false 到 repositories 顶部，避免 Composer 因网络超时或缓存卡住，尤其在 CI 或离线环境

path 仓库下 composer install 和 update 的行为差异

装完之后，vendor 里出现的是符号链接（macOS/Linux）或 junction（Windows），不是复制文件。所以改本地包代码，项目里立刻可见——但这也带来几个关键约束：

• composer install 只会创建链接，不会检查本地包是否更新；改了本地代码，不需要重装
• composer update xxx 会重新解析依赖，可能意外切到远程最新版（如果 packagist.org 没关），导致链接断开
• 执行 composer update 全局时，只要 require 没变，path 包不会被替换；但如果删了 vendor 再 install，链接会重建，依然指向原路径
• CI 环境慎用：路径不存在就失败，建议只用于本地开发，CI 改用 dist 或私有 repo

为什么 path 仓库不生效？重点查这三处

最常卡在这几个点，而不是语法写错：

• 路径里有空格或中文？Composer 有些版本会解析失败，换路径或改名
• 本地包的 composer.json 缺 autoload，或者 psr-4 的命名空间和实际目录结构对不上，导致类加载失败，看起来像“没装上”
• 用了 composer create-project 初始化项目？它默认带 packagist.org 仓库，且优先级高，必须显式禁用，否则 path 被忽略

路径仓库不是黑魔法，它只是把本地目录“映射”进 Composer 的包发现流程。一旦 name、路径、版本写法、仓库优先级中有一处没对齐，就会静默跳过——它不会报错，只会去 Packagist 找，然后告诉你找不到。