Composer用path仓库加载本地包需三者对齐：主项目repositories配置（路径合法且含composer.json）、本地包name/version与require严格匹配、本地包自身composer.json启用"options":{"symlink":true}，缺一则vendor为复制副本，改代码不生效。
Composer 用 path 仓库加载本地包，不是“写个路径就能用”，而是三处必须同时对齐：主项目 composer.json 的 repositories 配置、本地包自身的 name 和 version 声明、以及是否启用符号链接。任意一环错，vendor 里出现的就是复制副本，改代码完全不生效——这个现象静默且难排查。
repositories 中的 path 配置怎么写才被识别
Composer 只有先在 repositories 里声明了“这个目录是个包源”，后续 require 才可能命中它。写错最常见的是路径格式和 JSON 语法。
-
url必须是双引号包裹的字符串，不能裸写路径（如url: ../my-pkg会 JSON 解析失败） - 推荐用绝对路径（如
"url": "/Users/me/my-pkg"），相对路径只接受以../或./开头的写法，不支持~/或file://协议 - 路径指向的是**目录**，不是
composer.json文件本身；该目录下必须存在合法的composer.json（无语法错误、无尾逗号、全用双引号） - Windows 下路径分隔符用
/或\，单反斜杠会导致解析失败
require 的包名和版本为什么总不匹配
path 类型仓库不做语义化版本解析，只做字符串比对。你 require 的内容，必须和本地包 composer.json 里的 name 和 version 字段严格一致（包括大小写、vendor 名、分隔符）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 本地包
composer.json写了"name": "acme/logger"，你就得require"acme/logger"，写成"Acme/logger"或"acme/logger-dev"都会报Could not find package - 如果本地包没写
version字段，Composer 默认按当前 Git 分支推断：main →dev-main，develop →dev-develop；此时require必须写"dev-main"或"*@dev"，不能写"^1.0" - 若本地包写了
"version": "dev-main"，但主项目minimum-stability是stable（默认），需显式加"minimum-stability": "dev"到主项目根级，否则dev-main被直接忽略
为什么 vendor 里是复制而不是 symlink
Composer 默认行为就是复制，symlink 必须显式启用，且只对 path 类型仓库生效。很多人以为在主项目配 "symlink": true 就行，其实关键在本地包自己的 composer.json。
- 最稳妥方式：在**本地包的
composer.json** 里加"options": {"symlink": true}（注意不是主项目的配置） - Windows 下需管理员权限运行终端，否则
mklink失败，Composer 会静默 fallback 成硬拷贝 - 启用后，
composer install或composer update vendor/name才会创建符号链接；仅composer dump-autoload不会重建链接 - 验证是否成功：
ls -la vendor/acme/logger（macOS/Linux）应显示-> /path/to/local；Windows 可用dir查看是否为Junction
修改本地包代码后类找不到怎么办
符号链接生效 ≠ 自动加载就绪。改了文件结构、命名空间或类名，但没更新自动加载映射，就会报“类不存在”。
- 确认本地包的
autoload配置（如psr-4）是否覆盖实际文件路径，前缀和目录映射别写反 - 改完本地包后，必须在主项目中执行
composer dump-autoload -o，生成优化后的映射 - 某些环境（如 PHP-FPM、opcache 启用时）会缓存旧类路径，需重启服务或清理 opcache
- IDE（如 PhpStorm）有时不会自动重索引 symlink 目录，可手动刷新或重启 IDE
真正麻烦的点不在配置本身，而在于它高度依赖本地环境状态：路径是否存在、Git 分支名是否一致、Windows 权限是否到位、opcache 是否清空——这些条件缺一不可，且报错信息往往不指向真实原因。调试时建议从 ls -la vendor/xxx 和 cat ../my-pkg/composer.json | jq .name 这类最原始的命令开始验证。
