必须先启用Windows LongPathsEnabled注册表项，否则镜像切换等操作无效；因镜像仅改变下载路径，不缩短vendor解压后的嵌套路径，而“文件名太长”错误发生在Windows内核级MAX_PATH=260限制下的解压阶段。
必须先启用 Windows 的 LongPathsEnabled 注册表项，否则任何镜像切换、缓存重定向或参数调整都只是临时缓解，甚至完全无效。
为什么改镜像解决不了“文件名太长”问题
Composer 镜像（如阿里云、腾讯云、华为云）只影响包下载地址和 dist 压缩包获取路径，不改变解压后 vendor 目录的嵌套结构或文件系统路径长度。报错发生在解压阶段（ZipArchive::extractTo() 或系统 unzip 调用），而 Windows 的 MAX_PATH = 260 限制在此刻直接拦截——镜像再快，也绕不过内核级路径校验。
- 所有国内镜像均无法缩短
vendor/symfony/console/Tests/Fixtures/Command/CommandWithVeryLongNameAndDeepNamespace/...这类路径 - 即使换用
--prefer-dist，压缩包解压后仍会展开相同深度的目录树 - 某些镜像返回的
dist包本身含更长文件名（如带 commit hash 的 tarball），反而加剧问题
启用 LongPathsEnabled 是唯一根本解法
这是 Windows 10 1607+ / Server 2016+ 内置机制，需显式开启才能让 php.exe 和 composer.phar 调用 NTFS 驱动时跳过 260 字符硬检查。Composer 2.2+ 已在 manifest 中声明兼容，但开关默认关闭。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 以管理员身份运行 PowerShell，执行：
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -Type DWORD
- 关闭并重新打开所有终端（CMD/PowerShell/Git Bash）、IDE（VS Code/PHPStorm）和资源管理器窗口
- 验证是否生效：
Get-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled"
返回值应为1 - 注意：家庭版 Windows 无
gpedit.msc，注册表方式是唯一可靠路径
配合短路径配置才能稳定运行
即使开了 LongPathsEnabled，部分 PHP 扩展（如 ziparchive 在旧版 VC 编译中）、Git for Windows 或 IDE 文件监听仍可能因路径计算误差失败。必须同步收紧关键路径：
- 把项目放在极短路径下，例如：
D:\p\myapp，而非C:\Users\Alice\Documents\GitHub\my-super-long-project-name\ - 全局重定向缓存：
composer config --global cache-dir "C:\c"
（手动创建C:\c目录） - 避免
COMPOSER_HOME落在%APPDATA%深路径里：setx COMPOSER_HOME "C:\comphome"
，重启终端后生效 - 慎用
vendor-dir设为绝对路径（如C:\v）：虽能脱离项目层级，但会破坏相对 autoload 映射，需同步调整composer.json中的autoload段
临时绕过命令仅用于诊断，不可长期依赖
--no-scripts --no-plugins 或 --no-dev 确实能让 composer install “跑通”，但这只是跳过易出错环节，并未解决路径膨胀本质。后续执行 composer dump-autoload 或 composer run-script post-install-cmd 仍可能失败。
-
--no-scripts：跳过autoload-dump、post-install-cmd等，但 vendor 已解压，路径长度未变 -
--no-dev：减少依赖数量，对 Symfony/Doctrine 类“巨无霸”包效果明显，但无法解决单个包内部嵌套深的问题 -
--prefer-dist+--no-plugins组合可能触发pre-install-cmd插件缺失导致的隐性错误，尤其在 CI 环境中
真正稳定的构建流程，必须建立在 LongPathsEnabled=1 + 短基础路径 + 短缓存路径 三者同时满足的基础上。漏掉任意一环，都可能在某次 composer update 或新依赖引入后突然复现。
