Composer 不支持直接用 file:// 协议作镜像源，因其要求 composer 类型仓库提供 packages.json 索引，而本地路径无服务层；应改用 path 类型直引或搭建 Satis 本地 HTTP 镜像。
为什么不能直接用 path 协议当 Composer 镜像源
Composer 官方不支持把本地文件路径（比如 /path/to/my-packages）直接当作镜像源（repositories type composer）使用。你尝试配置 "type": "composer", "url": "file:///xxx" 会报错：Invalid repository type "composer" 或 Could not fetch packages...，因为 Composer 的 composer 类型仓库必须提供符合 Packagist 协议的 packages.json 索引，而纯目录没有这个服务层。
正确做法：用 path 类型仓库替代镜像源
path 类型不是镜像，而是本地包直引机制——它跳过网络请求和索引解析，直接 symlink 或 copy 包内容。适合开发中调试私有包、复用未发布组件。
- 在项目
composer.json中添加：{ "repositories": [ { "type": "path", "url": "../my-private-package" } ], "require": { "vendor/my-private-package": "*" } } -
url必须是相对或绝对路径，支持 glob（如../packages/*），但路径需存在且含有效composer.json - 运行
composer install后，默认 symlink（Windows 需管理员权限或启用options.symlinks = false） - 修改本地包代码后，无需
composer update，直接生效（symlink 模式下）
path 类型的坑：版本约束与稳定性
path 仓库会忽略远程版本号，只认本地 composer.json 中的 version 字段（或自动推断为 dev-main）。如果没写 version，Composer 默认当成 dev-main，此时 "require": {"vendor/pkg": "1.0"} 会失败。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 确保本地包
composer.json显式声明"version": "1.0.0"，或使用"dev-main"约束 -
composer require vendor/pkg:dev-main是最稳妥的写法 - 若多个
path包互相依赖，注意循环引用会导致composer install卡住 - CI/CD 环境会因路径不存在而失败，务必在
.gitignore或部署脚本中排除repositories配置
真要镜像？那就搭个本地 Composer HTTP 服务
如果确实需要“镜像”行为（比如缓存所有依赖、离线可用、统一代理），path 不够用。得用工具生成静态 packages.json 并起 HTTP 服务：
- 用
composer-satis扫描本地包目录，生成索引：php bin/satis build ./satis.json ./web/ -
satis.json中"repositories"列出本地路径，"output-dir"设为./web - 用 PHP 内置服务器启动：
php -S localhost:8000 -t ./web - 然后在项目中配
{"type": "composer", "url": "http://localhost:8000"} - 注意：每次新增包都要重新 run
satis build，不然索引不同步
真正麻烦的地方不在配置，而在维护索引一致性——本地改了包，忘了 rebuild satis，就会装到旧版本。别图省事跳过这步。
