应立即使用--prefer-dist参数或配置"prefer-dist": true，让Composer改用复制方式安装包而非符号链接，这是官方支持的稳定降级方案，可彻底绕过权限限制问题。
Composer install 时提示 “Failed to create symbolic link” 怎么办
这是 Composer 在 Windows（尤其 NTFS 未启用开发者模式）、某些 Docker 容器、或挂载的网络/只读文件系统上常见的报错，本质是 symlink() 系统调用被拒绝。默认情况下 Composer 会优先尝试创建符号链接来复用 vendor 包，失败就直接报错退出——但其实它内置了降级方案。
启用 --prefer-dist 或配置 COMPOSER_PREFER_DIST 环境变量
让 Composer 放弃链接，改用复制方式安装包（即下载 zip 包并解压），绕过符号链接依赖。这不是临时 workaround，而是官方支持的稳定模式。
-
composer install --prefer-dist：对当前项目生效，适合 CI 或受限环境一键修复 -
COMPOSER_PREFER_DIST=1 composer install：Linux/macOS 下临时启用；Windows 可用set COMPOSER_PREFER_DIST=1后再运行 - 永久写入
composer.json的"config"段："prefer-dist": true（注意：该配置仅影响当前项目）
修改全局配置强制所有项目走复制模式
如果你长期在 WSL2、Docker 或企业锁定的 Windows 环境中工作，全局设为复制更省心。Composer 不会因为你开了开发者模式就自动切回 symlink——它只看当前上下文是否允许创建链接，而不会“试探性 fallback”。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config -g prefer-dist true，写入全局~/.composer/config.json - 验证是否生效：
composer config -g prefer-dist应输出true - 注意：该设置不影响已用
--prefer-source显式指定的命令，也不影响create-project的默认行为（它默认就是 dist）
为什么不用 --no-scripts 或 --no-plugins 来规避
这两个选项和符号链接错误完全无关。--no-scripts 是跳过 post-install-cmd 等钩子，--no-plugins 是禁用插件——它们既不触发 symlink，也不阻止 symlink 失败。试图靠它们“绕开问题”，只会让你在下一次 composer update 时再次撞墙。
真正要盯住的是 composer.json 里有没有误配 "preferred-install": "source"，或者项目根目录下有没有残留的 .git 导致 Composer 自动倾向 source 模式（因为 source 需要 git clone，而 clone 本身又可能依赖 symlink）。删掉 .git 或显式加 --prefer-dist 才是直击要害。
符号链接不是“可选优化”，而是 Composer 默认工作流的基础设施。一旦文件系统不认它，就得明确告诉 Composer：“别试了，直接拷。” 这个决策点藏在参数和配置里，而不是错误信息里——所以看到 symlink 报错，第一反应不该是查权限，而是立刻加 --prefer-dist。
