唯一有效的本地包引入方式是在根目录composer.json的repositories中添加type为"path"的条目；其他方式如改require块、加file://前缀或仅修改autoload均无效。
直接改项目根目录的 composer.json，在 repositories 里加一个 type: "path" 条目，是唯一能被 composer install 和 composer require 识别的本地包引入方式。其他写法——比如塞进 require 块、加 file:// 前缀、或只改 autoload——全都不生效。
为什么 composer require vendor/name 会报 “Could not find package”
常见错误现象：明明本地包目录存在、composer.json 也写了 name，但执行 composer require 就报找不到包。
-
repositories没配，或配错位置（比如写在require里面、或缩进不对） - 本地包的
composer.json缺name字段，或大小写/斜杠与require中写的不一致（acme/my-pkg≠acme/My-Pkg） - 本地包没
version，而你require的是具体版本号如"1.0.0"；path 仓库只认*、dev-main、dev-develop这类通配或分支别名 - 没加
"packagist.org": false到repositories顶部，Composer 卡在远程源超时，导致本地源根本没被扫描
url 路径怎么写才不会跨平台出错
Windows 和 Linux/macOS 对路径处理不同，硬写绝对路径极易失效。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 推荐用相对路径：
"url": "../my-local-package"或"url": "./packages/helper"，从项目根目录composer.json所在位置算起 - 绝对路径在 Windows 必须用
C:/Users/xxx格式（正斜杠），不能用C:\Users\xxx（反斜杠会被 JSON 解析为转义） - 严禁加
file://前缀——Composer 会直接忽略该仓库 - 路径中含空格或中文？尽量避免；若必须，确保整个路径被双引号包裹且无非法字符
改了本地包代码，为什么新方法还是调不到
这不是自动加载缓存问题，而是符号链接没刷新。path 类型包默认走 symlink，但链接只在 install 或 update 时建立/更新。
- 首次引入后，运行
composer install或composer update vendor/name - 后续修改本地包源码，**必须再运行
composer update vendor/name**（指定包名更快，避免全量更新） -
composer dump-autoload完全无效——它只重生成自动加载映射，不触碰 vendor 下的链接 - 确认是否启用软链：
"options": { "symlink": true }是默认值，但某些旧版 Composer 或 Windows 可能 fallback 为 copy；可显式加上并检查vendor/vendor/name是否是快捷方式/符号链接
CI/CD 和上线前最容易被忽略的点
path 仓库不是开发便利功能，而是“临时绕过发布流程”的调试手段，生产环境必须隔离。
- CI 流水线里，
url对应的路径几乎肯定不存在，会导致composer install直接失败 - 上线前必须删掉
repositories里的 path 条目，并把require中的*或dev-main换成真实稳定版本（如"^2.1"） - 错误堆栈里可能暴露本地绝对路径（比如
/home/dev/my-project/packages/core/src/Helper.php），线上环境需禁用或清理路径信息 - 若团队协作，务必在 README 或 CONTRIBUTING.md 里注明：“本地开发需启用 path 仓库，CI 自动跳过”
