答案是：composer本地包依赖解析失败90%因repositories未正确配置"type":"path"，必须严格匹配包名、路径指向含合法composer.json的目录，且需删除vendor和lock后重装。
composer.json 的 repositories 配置必须写对 type: "path"
本地包依赖解析失败，90% 是因为 repositories 里没写 "type": "path"，或者写成了 "type": "vcs" 或 "type": "composer"。只有 type: "path" 才会让 Composer 去文件系统里找本地目录，并读取其中的 composer.json 来解析依赖。
正确写法示例（项目根目录 composer.json）：
{
"repositories": [
{
"type": "path",
"url": "../my-shared-package"
}
],
"require": {
"myorg/my-shared-package": "*"
}
}
-
url必须是相对于项目根目录的路径，不能是绝对路径（如/home/user/pkg），也不能含~或环境变量 -
url指向的目录下必须存在有效的composer.json，且该文件中name字段值（如"myorg/my-shared-package"）要和require中的包名完全一致（大小写敏感） - 如果
url指向的是软链接目录，Windows 下可能失效；建议直接用真实路径
本地包的 composer.json 必须声明 name 和 version
本地包自己的 composer.json 如果缺 name 或 version，Composer 会跳过它、报错或静默忽略——不会提示“找不到包”，而是表现为 require 的包始终无法安装。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
最小可用配置示例（../my-shared-package/composer.json）：
{
"name": "myorg/my-shared-package",
"version": "dev-main",
"require": {
"php": "^8.1"
}
}
-
version不能留空；开发中常用"dev-main"、"dev-develop"或"1.0.x-dev" - 若本地包还依赖其他包（比如
symfony/console），这些也要写在它的require里，Composer 会递归解析并装进主项目的vendor - 不要在本地包里写
autoload-dev并期望主项目自动加载测试类——除非主项目显式 require 它，否则不生效
install 后默认是 symlink，但需确认系统支持且未被禁用
运行 composer install 后，本地包默认以符号链接（symlink）方式接入 vendor/myorg/my-shared-package。这意味着你改本地源码，项目里立刻可见效果。但这个行为不是绝对的：
- Windows 默认不启用 symlink，除非以管理员身份运行终端，或执行过
git config --global core.symlinks true - 某些 CI 环境（如 GitHub Actions 的 ubuntu-latest）默认禁用 symlink，需加
--no-symlinks参数或改用"options": {"symlink": false}在repositories里显式关闭 - 如果想强制复制而非链接（例如部署时需隔离变更），可在
repositories条目里加"options": {"symlink": false} - symlink 失败时 Composer 不报错，而是悄悄 fallback 成 copy，但 IDE 可能仍显示“external file”，导致跳转失效
依赖冲突常因本地包用了 dev 分支却没设 stability
本地包用 "dev-main" 这类版本时，Composer 默认按 minimum-stability: stable 过滤，结果就是“明明写了 require 却装不上”。这不是路径问题，而是稳定性策略拦截。
- 解决方法一：在主项目
composer.json顶层加"minimum-stability": "dev"，并配"prefer-stable": true（平衡稳定与开发需求） - 解决方法二：不改全局 stability，在
require中显式指定分支别名："myorg/my-shared-package": "dev-main as 1.0.0"，让 Composer 把它当正式版处理 - 检查是否真被过滤：运行
composer show myorg/my-shared-package，如果返回空或报Package not found，大概率是 stability 拦截了
repositories 或本地包 composer.json 后，必须删掉 vendor 和 composer.lock 再 composer install——composer update 不会重新扫描 path 仓库，旧 lock 文件会固化错误解析结果。
