composer install 默认不创建符号链接，因其设计优先保障构建可重现性；仅当本地包composer.json含"options":{"symlink":true}、系统支持、composer≥2.2且非dist类型时才生效，否则静默回退为复制。
为什么 composer install 后 vendor 里不是符号链接
默认不创建 symlink，这是 Composer 的显式设计选择，不是 bug 或配置遗漏。它优先保障构建可重现性，而非开发便利性。只有满足全部条件时，symlink 才会生效：
• 主项目或本地包的 composer.json 中显式声明了 "options": {"symlink": true}（关键在本地包自己的 composer.json）
• 系统支持：Linux/macOS 默认可用；Windows 需管理员权限或启用开发者模式；Docker 容器需 --cap-add=SYS_ADMIN
• Composer 版本 ≥ 2.2
• 未被标记为 "dist" 类型（例如没设 "preferred-install": {"vendor/name": "dist"}）
若任一条件不满足，Composer 会静默 fallback 到复制（copy），且不报错——这是最常被忽略的调试盲区。
path 仓库 require 失败的 90% 原因是 name 或路径不匹配
Composer 不做模糊匹配，name 必须逐字一致：
• 大小写敏感："acme/utils" ≠ "Acme/Utils" ≠ "acme_utils"
• 分隔符只能是短横线 -，不能用下划线 _ 或驼峰
• 路径必须指向含 composer.json 的目录，不是文件本身，末尾不能带 /（如 "../my-pkg/" 会被静默忽略）
• 相对路径以主项目 composer.json 为基准，不是 shell 当前工作目录
验证方式：composer show --all | grep vendor/name，若无输出，基本就是 name 或路径错了。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
改了本地包代码，为什么项目里不生效
根本原因不是 autoload 没刷新，而是 symlink 没重建或压根没启用：
• composer install 从不更新已有 symlink，只补缺；必须运行 composer update vendor/name
• 若本地包 composer.json 缺 "options": {"symlink": true}，即使主项目配了也无效
• Windows 下普通终端权限不足，dir vendor\vendor\name 显示普通文件夹而非 JUNCTION，说明已 fallback 到 copy
• autoload 生效的前提是 symlink 成功：只有真实路径被载入，composer dump-autoload -o 才能生成正确映射；否则 use 语句仍会报 Class not found
CI/CD 环境下 path 仓库必须移除
CI 流水线中 repositories 里的 path 条目必然失败，因为目标路径在构建机上不存在。这不是配置问题，是设计约束：
• composer install 依赖 composer.lock 中记录的 source.type 和 url，但 CI 无法解析本地相对路径
• 即使硬编码绝对路径，不同 runner 机器路径也不一致
• 正确做法：上线前用脚本或 CI 步骤自动删除 repositories 中所有 "type": "path" 条目，再提交或覆盖 composer.json
• 本地开发用 path + symlink，发布用 Packagist 或私有 Satis 仓库——两者不可混用同一份配置
