path类型必须配置在repositories中而非require里，需声明自定义path仓库并确保本地包composer.json含正确name、version及autoload，修改代码后须执行composer update而非dump-autoload。
path 类型必须写在 repositories 里，不是直接 require
很多人试过直接 composer require vendor/name:dev-main 然后加 "path": "./local-package" 到 require 块里——这完全无效。Composer 不解析 require 字段里的路径配置。
正确做法是把本地包声明为一个自定义仓库，再让 Composer 从那里拉取：
{
"repositories": [
{
"type": "path",
"url": "./local-package"
}
],
"require": {
"vendor/name": "*"
}
}
注意：url 是相对于 composer.json 所在目录的路径，不能用绝对路径（Windows 下 C:/xxx 或 Linux 下 /home/xxx 都会失败）；vendor/name 必须和本地包 composer.json 里的 "name" 完全一致，包括大小写。
本地包的 composer.json 必须有 name 和 version
缺 "name" 会导致 composer install 报错：Could not find package vendor/name at any version；没 "version" 或只写 "dev-main" 而不配 "minimum-stability": "dev"，则可能因稳定性约束被跳过。
最小可用配置示例：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"name": "myorg/utils",
"version": "1.0.0",
"autoload": {
"psr-4": { "MyOrg\Utils\": "src/" }
}
}
-
version可以是任意语义化版本（如"0.1.0-dev"），但不能留空或只写分支名 - 如果用
"dev-main"这类开发版号，主项目需同步加"minimum-stability": "dev"，否则 Composer 默认只认stable - 本地包里
autoload必须正确，否则即使安装成功，class not found错误照常出现
修改本地包代码后要 composer update，不是 dump-autoload
这是最常踩的坑：改完 local-package/src/Helper.php，运行 composer dump-autoload，发现新方法还是调不到。
因为 path 类型包走的是“符号链接”逻辑（Composer 5.6+ 默认启用），但链接本身不会自动更新——它只在 install 或 update 时建立/刷新。
- 首次引入：运行
composer install或composer update vendor/name - 后续改了本地包代码：必须运行
composer update vendor/name（指定包名更快），不是dump-autoload - 如果想实时看到改动，可确认是否启用了 symlink：
"options": { "symlink": true }在 repository 配置里（默认开启），否则是 copy 模式，更慢且不易察觉更新
Windows 下路径分隔符和权限问题很具体
Windows 用户常遇到 Could not scan for classes 或 failed to open dir，多数和路径有关：
– url 中不要用反斜杠 ，一律用正斜杠 /（"./local-package" ✅，".local-package" ❌）
– 如果本地包目录在另一磁盘（比如 D:pkg），不能直接写 "D:/pkg"，得用相对路径挪到同一盘符下，或改用 WSL 环境
– 杀毒软件有时会锁住 symlink，导致 composer update 卡住或报错 Operation not permitted，临时禁用实时防护试试
复杂点在于：path 类型看着简单，但它混合了文件系统权限、Composer 的稳定性策略、自动加载机制三层耦合。漏掉任一环，表现都是“包好像装上了，但用不了”。
