根本原因是Composer未识别本地目录，必须同时满足：主项目composer.json正确配置repositories、本地包路径为相对路径、本地composer.json的name与require完全一致、启用symlink且已执行composer update。
为什么 composer require vendor/name:dev-main 总报 “Could not find package”
根本原因不是网络卡、镜像慢或权限问题，而是 Composer 根本没“看见”你的本地目录。它只在 repositories 数组里找源，require 字段只声明“我要哪个包”，不负责“去哪找”。
必须同时满足以下全部条件：
-
repositories配置写在主项目（即你正在开发的那个项目的）composer.json根级，不能写在本地包自己的composer.json中 -
url必须是相对路径（如"../my-package"），绝对路径在 Windows 上极易静默失败（盘符、反斜杠、空格都会中断） - 本地包目录下必须有合法的
composer.json，且其中name字段（如"acme/utils"）要和require里写的完全一致（大小写敏感） - 版本约束必须用
dev-main、dev-develop这类分支名，不能写1.0.0——path 源下 Composer 忽略version字段，只认当前 Git HEAD 所在分支
怎么让改完本地包代码立刻在主项目里生效
默认行为是复制（copy），不是符号链接（symlink）。你改了 ../my-package/src/Helper.php，vendor/acme/utils/Helper.php 仍是旧文件。
必须显式启用符号链接：
- 在主项目
composer.json的对应repositories条目里加"options": {"symlink": true} - 或在本地包自己的
composer.json里加同样字段（效果等价） - 执行
composer update acme/utils（不是dump-autoload），才会重建 symlink - 验证是否成功：
ls -la vendor/acme/utils应显示箭头指向源目录；Windows 用户用dir vendor\acme\utils看是否为“快捷方式”类型
注意：Windows 需开启开发者模式或以管理员权限运行命令行，否则 symlink 创建会失败且无提示。
composer install 为什么没拉下本地包
path 仓库不支持 composer install 自动发现——它不会像 Packagist 那样从元数据推导依赖。你必须先 require，再 update，否则 vendor/ 里什么都不会有。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
常见错误操作：
- 只改了
repositories和require，但没运行composer update vendor/name - 用了
--no-dev，但本地包的composer.json里写了"minimum-stability": "dev"，导致被跳过 - 目标包目录没运行过
git init，或没提交至少一次（Composer path 源依赖 Git 分支信息）
唯一靠谱的验证方式是加 -vvv：运行 composer install -vvv 或 composer update -vvv，看到日志里出现 Installing acme/my-private-package (dev-main): Symlinking from ../my-private-package 才算真正生效。
path 仓库和 Packagist 仓库的关键区别在哪
不是“能不能装上”，而是“怎么装、怎么更新、怎么维护”。
path 类型直接读取本地 composer.json 内容，跳过所有远程元数据请求（不连 Packagist、不查 packages.json），因此它天然离线、极快，但也更脆弱：
- 无法自动同步版本号：你改了本地包
composer.json里的version，主项目完全不感知，仍按当前 Git 分支名解析（如dev-main） - 不校验完整性：没有 hash 校验，改错文件也不会报错
- 路径含空格或中文时，Composer 会静默失败，建议用纯英文+下划线命名
- 不要在
repositories里混用 packagist 和 path 同名源（比如都叫acme/utils），否则行为不可预测
最易忽略的一点：本地包目录必须已运行 git init 并至少有一条 commit——Composer path 源靠 Git 分支名定位，不是靠文件系统时间戳或内容哈希。
