Path仓库的name和路径必须严格匹配，否则所有系统均失败：name须全小写、仅含短横线-、vendor/name格式且与require逐字一致；url须指向含合法composer.json的目录，且为相对于主项目composer.json的路径（不可带末尾/），Windows需管理员权限，symlink生效依赖本地包自身配置"options": {"symlink": true}。
path仓库的name和路径必须严格匹配，否则Windows/Linux/macOS都会失败
Composer不因系统不同而放宽校验，name字段大小写、分隔符（只允许短横线-）、vendor名必须与require中字符串逐字一致；url必须指向含composer.json的目录，且是相对于主项目composer.json的位置，不是当前shell工作目录。
常见错误包括：
-
"acme/utils"写成"Acme/utils"或"acme_utils"，Windows下尤其容易因大小写不敏感误以为能过，实则Linux/macOS直接报Could not find package -
"url": "./packages/my-pkg/"末尾多了一个/，导致静默忽略整个仓库 - 本地包根目录下没有
composer.json，或文件有尾逗号、单引号、中文引号等语法错误 - Windows路径含空格或中文，某些PHP版本解析失败（如
"../my pkg"）
symlink是否生效，关键看本地包自己的composer.json里有没有options
符号链接不是由主项目控制的，而是由被引用的本地包决定。主项目配了"type": "path"，只是打开了门；真正开关在本地包的composer.json里——必须显式声明"options": {"symlink": true}，否则即使Linux/macOS也会fallback到复制，Windows更大概率静默失败。
验证方式：
- Linux/macOS：
ls -la vendor/vendor/name，看到箭头->才是软链 - Windows：
dir vendor endor ame，看到JUNCTION或SYMLINKD才对 - 若显示为普通文件夹，说明已fallback为copy，改本地代码不会实时生效
Windows用户还需以管理员身份运行终端，Docker需加--cap-add=SYS_ADMIN并确认挂载支持symlink。
autoload映射失效，90%是因为本地包没正确配置autoload
即使composer install成功、symlink也建好了，new AcmeFoo()仍报类找不到，问题往往不在主项目，而在本地包自身的autoload字段没写对。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
必须满足：
- 本地包
composer.json中"autoload"（或"autoload-dev"）字段存在且语法合法 - PSR-4映射的命名空间前缀与实际目录结构严格对应，例如
"Acme\": "src/"要求src/下有Acme/子目录 - 路径全部用正斜杠
/，不能用DIRECTORY_SEPARATOR拼接，也不能出现反斜杠 - 执行
composer dump-autoload -o手动刷新映射（install和update默认不触发此步）
检查vendor/composer/autoload_psr4.php里是否出现\字符，有则说明该包未适配PSR-4规范。
跨平台脚本调用path包时，避免硬编码shell命令
如果本地包的composer.json里定义了scripts（比如"post-install-cmd": "cp .env.example .env"），这些命令在Windows下必然失败——cp不存在，rm -rf也不被识别。
解决方案只有两个：
- 删掉所有shell命令，改用PHP脚本实现相同逻辑（用
copy()、unlink()、scandir()等） - 或彻底移出
scripts，交由CI/CD流程或开发者手动执行
不要指望Composer帮你翻译命令，它不做任何兼容层；也不要依赖Git Bash或WSL来“模拟”环境，因为CI容器、生产服务器很可能连bash都没有。
