根本原因是项目根目录composer.json未声明type为path的repositories、本地包无合法composer.json、或其name字段与require不一致；三者缺一不可。
本地包路径没被识别，composer install 报 Could not find package xxx at any version
根本原因不是路径写错，而是三个硬性条件缺一不可：项目根目录的 composer.json 里必须声明 "type": "path" 仓库；本地包目录下必须存在合法的 composer.json；且其中 name 字段要和你在主项目中 require 的完全一致（包括 vendor 名）。
常见踩坑点：
- 把
repositories写在本地包自己的composer.json里——它只对自身生效，主项目看不到 - 路径用了
~/my-pkg或$HOME/my-pkg——Composer 不解析环境变量，只认绝对路径或相对路径（如../my-pkg） - 本地包
composer.json中version写成"1.0.0"，但主项目require写的是"dev-main"——版本约束不匹配，Composer 直接跳过该源 - 本地包目录权限受限（尤其 Windows 下 OneDrive 同步文件夹），导致 Composer 读不到文件内容
require 时该用什么版本号？dev-main 还是 dev-master？
取决于本地包的默认分支名。Git 仓库初始化后默认分支已普遍为 main，所以优先用 "dev-main"；若本地包仍为 master 分支，则对应写 "dev-master"。别写 "*@dev" 或 "^1.0"——这些会绕过 path 源，退回到 Packagist 查找。
实操建议：
- 进本地包目录，运行
git branch --show-current确认当前分支名 - 在主项目
composer.json的require段写死该分支名，例如："myvendor/mypkg": "dev-main" - 如果本地包尚未初始化 Git，直接在它的
composer.json里加"version": "dev-main"，否则 Composer 无法推断版本
改了本地包代码，主项目为什么没热更新？
因为 Composer 默认对 path 类型仓库启用符号链接（symlink），但前提是文件系统支持且权限允许。Windows 下若未以管理员身份运行终端、或 NTFS 禁用了创建符号链接的策略，Composer 会自动 fallback 到复制模式（copy），此时修改本地包不会同步到主项目 vendor/ 下的副本。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
验证与修复：
- 检查
vendor/myvendor/mypkg是否是快捷方式（Windows）或符号链接（Linux/macOS）：在终端里运行ls -la vendor/myvendor/mypkg，看到->即为软链成功 - 若不是软链，删掉
vendor/myvendor/mypkg，再执行composer update myvendor/mypkg强制重装 - 仍失败？在项目根
composer.json的config段加"symlink": true，并确认 PHP 进程有symlink()权限（Windows 需开启开发者模式或以管理员运行）
多个本地包共存时，repositories 怎么写才不冲突？
每个 path 仓库必须独立声明，不能合并路径或通配。顺序无关紧要，Composer 会逐个匹配 require 中的包名，命中即停。
正确写法示例：
"repositories": [
{
"type": "path",
"url": "../pkg-a"
},
{
"type": "path",
"url": "../pkg-b"
}
]
注意：
- 不要写成
"url": "../pkg-*"——不支持 glob - 两个本地包若
name相同（比如都叫myvendor/core），Composer 只取第一个匹配的源，后一个被忽略 - 若本地包之间也有依赖关系（如 pkg-b require pkg-a），它们各自
composer.json中的require仍需写标准版本号，不能写dev-main——path 仓库只对顶层项目生效，不递归穿透
repositories 配置位置、name 字段拼写、分支名与 require 版本的一致性，这三点漏掉任一，composer install 就会静默跳过本地源。 
