绝对路径在 composer 的 path 仓库中可以工作但不推荐，windows 上易静默失败，跨平台不可靠且 ci/cd 中几乎必然崩；应优先使用相对路径或软链等替代方案。
绝对路径在 Composer 的 path 仓库中**可以工作，但不推荐，且 Windows 上极易静默失败**。它不是“不能用”，而是条件苛刻、跨平台不可靠、CI/CD 环境几乎必然崩——你看到 vendor 目录没链接、Could not find package 或直接 fallback 到 Packagist，八成是绝对路径惹的祸。
为什么绝对路径容易失效
Composer 对 url 字段的解析不经过 shell 展开，所有非相对路径特性（如 ~、$HOME、file://）全部被忽略；Windows 下盘符、空格、反斜杠、大小写混用会中断路径解析，且无明确报错。更关键的是：Docker 容器、CI runner、团队协作时，绝对路径根本无法复现。
-
"/home/user/my-pkg"在 macOS/Linux 可能成功，但在 GitHub Actions 的 Ubuntu runner 上指向不存在的用户家目录 -
"C:devmy-pkg"在 Windows 命令行中因反斜杠未转义或空格被截断，Composer 静默跳过该仓库 -
"D:/projects/my-pkg"虽语法合法，但若容器挂载路径为/app，宿主机 D: 盘根本不可见
绝对路径的唯一可行写法
如果真要硬上（比如本地调试单机环境），必须满足三个硬条件：
- 路径必须是**纯 ASCII 字符**，不含中文、空格、括号、特殊符号
- Windows 下必须用正斜杠
/或双反斜杠\，单反斜杠会被 PHP 解析为转义字符（如"C:my-pkg"→C:my-pkg） - 路径必须指向一个**含合法
composer.json的目录**，不是文件本身；且该composer.json中的name必须与require中完全一致
正确示例（Linux/macOS）："url": "/Users/you/projects/my-utils"
正确示例（Windows）："url": "C:/dev/my-utils" 或 "url": "C:\dev\my-utils"
比绝对路径更稳的替代方案
用相对路径 + 项目结构约定，一劳永逸避开平台陷阱：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 把本地包统一放在
./packages/下，用通配符：{"type": "path", "url": "./packages/*"}—— Composer 会扫描每个子目录下的composer.json - 在项目根目录建软链（仅开发机）：
ln -s /absolute/path/to/my-pkg packages/my-pkg，然后始终用"./packages/my-pkg" - 用
composer config --local注册路径（只影响当前项目）：composer config --local --add repositories.local type path&&composer config --local --add repositories.local url ./packages/my-pkg
验证绝对路径是否真被识别
别信 composer install 输出——它根本不读 repositories。运行：
composer config repositories
看输出里有没有你写的那条；再跑：
composer show vendor/name
如果报 Package not found，说明路径没进仓库列表，或 name 不匹配。此时 ls -la vendor/vendor/name 如果是普通文件夹而非带 -> 的符号链接，基本可判定 fallback 成了 copy，绝对路径已失效。
真正可靠的路径永远是相对于项目根目录的 ./ 或 ../；绝对路径不是“高级用法”，而是调试期临时绕过工具链限制的权宜之计——上线前务必切回相对路径。
