Composer不处理symlink循环引用，它只按composer.json解析依赖并创建链接；若../a指向../b且后者又链回前者，Composer不干预，但会导致ls、find卡死或PHP加载失败。
Composer 本身不处理 symlink 循环引用
Composer 不会检测、阻止或修复符号链接层面的循环引用。它只管按 composer.json 解析依赖树，然后在文件系统上创建链接——如果 ../a 指向 ../b，而 ../b 又软链回 ../a，Composer 完全不会干预，也不会报错。真正出问题的是后续操作：ls -la vendor/ 可能卡住，find 命令陷入无限遍历，PHP require 加载失败，甚至某些 IDE 直接假死。
path 仓库中 symlink 循环的真实成因
所谓“symlink 循环”，几乎都来自开发者手动或脚本误配的 repositories 路径，而非 Composer 自动行为。常见组合包括：
-
"url": "../pkg-a"和"url": "../pkg-b"，但pkg-a/composer.json的name是vendor/pkg-b，而pkg-b/composer.json的name又是vendor/pkg-a - 两个 path 仓库指向同一目录（比如都设为
../shared），但各自composer.json中的name冲突或相互 require - Windows 下用
mklink /D手动建了嵌套软链，比如vendor/a → ../a，而../a/vendor/b → ../../b，最终绕回自身
验证方法很简单：进 vendor/，对疑似包执行 ls -la（Linux/macOS）或 dir（PowerShell），观察箭头 → 是否形成闭环路径。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
如何让 Composer 绕过 symlink 循环风险
最稳妥的做法不是“修复循环”，而是从一开始就不依赖 symlink。以下方式可强制跳过链接逻辑：
- 加
--prefer-dist参数：composer install --prefer-dist—— 完全不用 symlink，改走 zip 解压 - 禁用全局 symlink 支持：
composer config -g allow-symlinks false（注意：这个配置项实际无效；正确写法是设环境变量COMPOSER_ALLOW_SYMLINKS=0或用--no-symlinks） - 对 path 仓库显式关闭 symlink：
"options": {"symlink": false}，写在对应 repository 对象内，不是根 config - 删掉所有
repositories.type === "path"配置，改用git类型 +dev-main分支，靠 clone 代替链接
注意："symlinks": true 必须放在 repositories 数组的每个 path 项里，写在 config 段或全局配置中完全被忽略。
循环引用和 symlink 是两回事，别混在一起查
很多人把 composer update 卡在 Resolving dependencies 当成 symlink 循环，其实那是真正的 PHP 包级循环依赖（A require B，B require A）。这种问题跟文件系统链接无关，composer depends --tree 才是正解。而 symlink 循环只影响文件操作和工具链，不会让 Composer 解析器挂起。一个项目可以同时存在 symlink 循环（不影响 install）和包级循环依赖（导致 update 失败），得分开排查。
