composer默认对path仓库采用复制而非软链接，必须在repositories中为对应仓库显式配置"options": {"symlink": true}，且需配合windows开发者模式、管理员权限、正确包名与版本约束（如"@dev"）、执行composer update vendor/name而非install，并确保本地包已git commit。
path仓库为什么没创建软链接
Composer 默认对 type: "path" 仓库的行为是复制文件，不是创建符号链接。哪怕你写了 "url": "../my-lib"，只要没显式启用 symlink，它就只是把整个目录拷进 vendor/，改源码完全不生效。
必须在 repositories 条目里加 "options": {"symlink": true}（注意：不是放在 config 下，也不是全局配置），例如：
"repositories": [
{
"type": "path",
"url": "../my-shared-lib",
"options": { "symlink": true }
}
]
Windows 用户还需确认已启用开发者模式，并以管理员身份运行终端；否则 symlink 创建静默失败，退化为复制，且无任何提示。
require写法错在哪导致包根本没加载
最常见现象是运行 composer update vendor/name 后 vendor/vendor/name 目录为空或不存在，甚至 composer show vendor/name 没输出——说明 Composer 根本没识别到该 path 仓库。
-
require中的包名（如"acme/utils"）必须与本地库composer.json中的"name"字段**完全一致**：大小写、斜杠方向、vendor 名都不能差一个字符 - 版本约束不能写
"^1.0"或"1.0.0"；path 仓库不提供版本元数据，Composer 找不到匹配，会直接跳过并回退到 Packagist。正确写法是"dev-main"、"dev-develop"或"*@dev" -
url值不能以./开头，也不能含~或环境变量；必须是相对于当前项目根目录的合法相对路径（如"../shared-lib"）或绝对路径（Windows 用C:/path/to/lib，正斜杠）
为什么 composer install 不触发 symlink
composer install 只读 composer.lock，不会重新解析仓库或重建链接。哪怕你刚配好 repositories 和 options，执行 install 也毫无反应。
必须运行：
composer update vendor/name
其中 vendor/name 是你要联调的包名，不能省略。如果想批量更新所有 path 类型依赖，可用 composer update --with-dependencies，但不如指定包名精准。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
另外，若之前失败过，Composer 可能缓存了错误元数据。建议先执行 composer clear-cache，再加 --no-cache 强制刷新：
composer update vendor/name --no-cache
团队协作时怎么避免 path 配置污染 Git
把 repositories 写进项目级 composer.json 并提交到 Git，等于给所有人埋雷：路径在别人机器上大概率不存在，CI 构建直接失败。
安全做法是用 composer config --global 把 path 仓库写进全局配置，不进版本库：
composer config --global repositories.local path "../../packages/utils"
前提是团队约定好本地路径结构（比如所有人在 ~/code/ 下放共享库），且每个成员单独执行一次该命令。
要关闭？执行：
composer config --global --unset repositories.local
注意：这种全局方式只适合开发阶段；上线前必须切换为 vcs 或私有 composer 源，否则无法审计、不可回滚、也没有版本语义。
git init && git commit ——Composer 2.9.6+ 会拒绝加载未提交的 Git 工作区，哪怕你根本没用到 Git 功能。
