必须在项目根目录composer.json的repositories数组中配置{"type":"path","url":"../my-package"}，url须为含合法composer.json的目录相对路径，且需加"options":{"symlink":true}并执行composer update vendor/name才能生效。
composer.json里repositories怎么配path才生效
必须写在项目根目录的composer.json根级repositories数组里，不能塞进require或config字段。格式要严格：type是"path"，url是相对路径（比如"../my-package"），不能带file://、不能用绝对路径（Windows下C:/xxx大概率静默失败）、也不能指向composer.json文件本身，而必须指向**含composer.json的目录**。
常见错误现象：Could not find a matching version of package vendor/name——不是包没放对，而是repositories根本没被读到，或者url路径拼错了、大小写不一致、目录里压根没有composer.json。
- 本地包目录下必须有合法
composer.json，至少含name和version（哪怕写"dev-main"） - 如果用了通配符如
"../packages/*"，每个匹配子目录都得有独立的composer.json - 不要把
repositories写进本地包自己的composer.json——它只对当前项目生效，不传递
为什么vendor里没出现软链接，改了代码也不生效
默认行为是复制（copy），不是符号链接（symlink）。你改了../my-package/src/Helper.php，vendor/vendor/name/src/Helper.php还是旧的——因为Composer没被要求“连过去”，只是拷了一份快照。
想让修改立刻生效，必须显式启用软链：
- 在
repositories条目里加"options": {"symlink": true} - Linux/macOS一般默认支持；Windows需开启开发者模式或以管理员权限运行命令行，否则创建失败且无提示
-
composer install不会重建已有链接，必须运行composer update vendor/name
验证是否成功：ls -la vendor/vendor/name（Linux/macOS）应显示->指向源目录；Windows可用dir vendor\vendor\name看是否为“快捷方式”类型。
composer install vs composer update，什么时候该用哪个
composer install只做三件事：读composer.lock、检查vendor是否完整、补全缺失的包（包括path包的链接）。它**不会刷新已有链接的目标路径**，哪怕你改了本地包的代码、甚至挪动了目录位置。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
真正触发重新解析path、重建symlink的是composer update：
-
composer update vendor/name：最快最安全，只重算该包，跳过其他依赖冲突风险 -
composer update无参数：全量重算，慢，且可能意外升级其他包（尤其当composer.json里约束宽松时） -
composer require vendor/name:dev-main首次引入时，也会创建symlink（前提是已配好repositories）
CI/CD环境别用path仓库——上线前务必从repositories中删掉对应条目，否则构建必然失败（路径不存在）。
本地包改了autoload配置，为什么类找不到
软链接只解决文件位置问题，不自动刷新类加载映射。改了本地包的autoload字段（比如加了新命名空间或PSR-4规则），主项目里new MyClass()仍会报错Class not found。
必须手动刷新自动加载器：
- 运行
composer dump-autoload（推荐加-o优化选项） - 如果本地包用了
psr-4或classmap，确保其composer.json里的autoload配置语法正确、路径相对于包根目录 - 注意：这个命令和symlink无关，它只处理
vendor/composer/autoload_*.php生成逻辑
最容易被忽略的是：path仓库下version字段基本无效，Composer只认Git分支名（如dev-main），所以require里写的版本约束必须和实际分支对得上，否则composer update会直接跳过解析。
