镜像源配置正确却仍报symlink错误，是因为镜像仅影响包下载地址，不改变vendor构建阶段的符号链接行为；错误源于文件系统不支持symlink，与网络、镜像无关，应启用--prefer-dist或全局配置prefer-dist true改用复制模式。
为什么镜像源配置正确却 still 报 symlink 错误
镜像源（如阿里云）只影响包的下载地址，不改变 Composer 安装时的底层行为。符号链接失败和镜像源完全无关——它发生在 vendor/ 目录构建阶段，由文件系统能力决定。即使你已成功从镜像下载 ZIP 包，后续解压并创建 symlink 时仍会崩。别在镜像配置上反复折腾，先确认是否真卡在这一步：错误信息里含 Failed to create symbolic link 或 symlink(): Operation not permitted，那就和网络、镜像、证书全无关系。
怎么绕过 symlink 直接走复制安装
Composer 原生支持降级为复制模式，这是官方方案，不是临时补丁。关键在于让 Composer 主动放弃 symlink 尝试，而不是等它失败再报错。
- 临时对当前项目生效：
composer install --prefer-dist（推荐 CI/本地受限环境一键修复） - Linux/macOS 临时全局启用：
COMPOSER_PREFER_DIST=1 composer install - Windows 临时启用：
set COMPOSER_PREFER_DIST=1 && composer install - 永久写入当前项目：
composer config prefer-dist true（修改composer.json的"config"段） - 永久全局启用（适合 WSL2/Docker/企业 Windows）：
composer config -g prefer-dist true，验证用composer config -g prefer-dist输出true
注意：--prefer-dist 和 "prefer-dist": true 都会跳过 git clone 和 symlink，改用下载 ZIP + 解压，彻底规避符号链接调用。
哪些配置会悄悄把你拉回 symlink 陷阱
即使开了 --prefer-dist，某些隐式配置仍可能覆盖它，导致 symlink 再次被触发：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"preferred-install": "source"出现在composer.json的"config"或全局配置中——它优先级高于prefer-dist，必须删掉或显式覆盖为"*": "dist" - 项目根目录存在
.git且没设--prefer-dist：Composer 会倾向 source 模式（因能复用 git history），而 source 模式在某些场景下仍会尝试创建 symlink - 命令里混用了
--no-dev却没带--prefer-dist：--no-dev不影响安装方式，不会自动降级
最稳做法是：删掉 .git（若非必要）、清掉 vendor/ 和 composer.lock，再跑 composer install --prefer-dist --no-dev。
压缩失败（zlib_decode/data error）和 symlink 是两回事
看到 zlib_decode(): data error 或 failed to extract，别急着改镜像或重装 PHP。这些错误发生在 ZIP 下载后解压环节，和 symlink 完全无关。真正要盯的是：
- PHP 是否真加载了可用的
ZipArchive类：php -r "new ZipArchive();"不报错才算通过 - 缓存是否损坏：
composer clear-cache后重试 - 临时目录是否可写、空间是否足够（
/tmp或%TEMP%） - 是否被 IDE/杀毒软件锁住
vendor/目录（关 VS Code、禁用 Windows Defender 实时扫描）
符号链接失败是“系统不让建软链”，压缩失败是“PHP 解不开 ZIP”。两者报错位置、触发条件、修复路径都不同——混在一起排查，只会延长故障时间。
