Composer path仓库require失败的90%原因是name或路径不匹配：name必须大小写、分隔符（仅短横线-）完全一致，路径须指向含composer.json的目录且相对于主项目，末尾不可加/；Windows需管理员权限，Docker需--cap-add=SYS_ADMIN；symlink生效依赖本地包composer.json中"options": {"symlink": true}；autoload更新需手动执行composer dump-autoload -o；Xdebug断点需确保IDE路径与真实磁盘路径一致。
path仓库配置后require失败，90%是name或路径不匹配
Composer 不会模糊匹配包名或路径，name字段必须和require中写的完全一致：大小写、分隔符（只能用短横线-，不能用下划线_或大写字母）、vendor 名全部对齐。路径也一样——url指向的是**含composer.json的目录**，不是文件，且必须是相对于主项目composer.json的位置（如"../my-pkg"），不能是 shell 当前工作目录下的相对路径。
常见错误现象：Could not find package vendor/name，但composer show --all里根本没出现该包名。
- 检查本地包根目录下是否存在合法
composer.json（无尾逗号、全双引号、语法有效） - 确认
name字段值与require中字符串逐字相同，例如"acme/utils"≠"Acme/utils" - 路径末尾不要加
/，"url": "../my-pkg/"会导致静默忽略整个仓库 - Windows 用户避免路径含中文或空格，某些 PHP 版本解析会失败
为什么改了代码没生效？symlink 没启用或 fallback 了
path 类型仓库默认尝试创建符号链接，但失败时会静默回退到复制（copy），结果你改本地源码，vendor/里还是旧副本——这是最隐蔽的调试陷阱。
关键不在主项目配"symlink": true，而在于**本地包自己的composer.json里是否声明了"options": {"symlink": true}**。缺这句，Windows 上即使管理员权限运行终端，也会 fallback；Docker 容器挂载宿主机目录时也常因权限丢失 symlink 能力。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 验证是否真用了 symlink：
ls -la vendor/vendor/name（Linux/macOS）或dir vendor endor ame（Windows），看到箭头或JUNCTION才是成功 - 若显示为普通文件夹，说明 fallback 成 copy，立刻检查本地包
composer.json是否漏了options段 - Windows 下必须以管理员身份运行终端，否则
symlink创建失败且无提示 - Docker 场景需在
docker run时加--cap-add=SYS_ADMIN并确保挂载方式支持 symlink
autoload 不生效，不是 Composer 没加载，而是映射没更新
path 仓库让包“存在”，但类能否被new或use，取决于 autoload 映射是否包含它的真实路径。即使本地包composer.json写了"psr-4": {"Acme\": "src/"}，主项目也不会自动识别——必须显式刷新。
别依赖composer update，它不重建 autoload 映射；也别指望composer install自动处理，因为 path 包不走 dist 安装流程。
- 改完本地包的
autoload配置或新增类后，必须在主项目中运行composer dump-autoload -o - 调试阶段禁用优化：
composer dump-autoload --no-optimize，避免 classmap 缓存干扰 - 如果本地包没配
autoload，可在主项目composer.json的autoload段里临时加一条"psr-4": {"Acme\": "../my-pkg/src/"}，再dump-autoload - PHP OPCache 会缓存类位置，CLI 调试时加
-d opcache.enable=0参数启动脚本
Xdebug 断点悬空，根源是路径映射错位
你在 IDE 里打开vendor/acme/utils/src/Helper.php打了断点，但请求进来不触发——大概率是因为 IDE 实际加载的是 symlink 目标路径的副本，或 autoload classmap 指向了旧路径，Xdebug 找不到对应源码行。
核心原则：Xdebug 只响应“真实磁盘路径”与“IDE 中打开文件路径”完全一致时的断点。
- 在 IDE 中右键文件 → “Show in Explorer/Finder”，确认路径是否指向 symlink 的源目录（如
/Users/me/my-pkg/src/Helper.php），而非vendor/下的链接本身 - PhpStorm 中进入
Settings → PHP → Servers，把localhost或 Docker 容器的/var/www/html/vendor映射到本地your-project/vendor，而不是your-project/../my-pkg - 避免用
composer install --optimize-autoloader，调试期始终用--no-optimize-autoloader - 断点必须手动点击行号左侧设置，不要依赖“Break at first line”，Xdebug 不会自动在 symlink 目标文件里停
