根本解法是启用windows长路径支持（注册表设longpathsenabled=1并重启），再配合项目移至短英文路径（如d:\p\myapp）、重定向composer缓存目录及使用--no-scripts临时安装，方可彻底解决pathtoolongexception。
Windows 中文路径本身不触发“路径过长”，但会放大问题
报错 Path too long 或 The filename or extension is too long 的根本原因是 Windows 默认 260 字符的 MAX_PATH 限制，不是中文导致的。但中文路径（如 C:\我的项目\）会额外引入 UTF-16 编码膨胀、部分 PHP 扩展（如 ziparchive）转义失败、Git 命令行工具兼容性差等问题，让本就临界的状态直接崩掉。
常见错误现象包括：mkdir(): Invalid argument、symlink(): No error、解压中途静默退出、composer install -vvv 日志卡在某个深度嵌套的 src/ 目录下。
- 不要把项目放在含中文、空格、括号的父目录里（例如
C:\用户\张三\桌面\新项目） - OneDrive / iCloud / 腾讯微云等同步文件夹自带长前缀，且对中文路径更敏感，必须避开
- 确认当前终端工作目录是项目根（含
composer.json），别在src/或tests/子目录里运行composer install
必须先启用 Windows 长路径支持（注册表方式，家庭版适用）
没这步，其他所有操作都是临时补丁，大概率在 --prefer-source 或后续 git pull 时再次失败。
以管理员身份运行 PowerShell，执行：
Set-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled" -Value 1 -Type DWORD
然后关闭所有已打开的终端、IDE（VS Code、PHPStorm）、Git Bash 窗口——不是只关窗口，要杀掉对应进程（任务管理器里看 PowerShell.exe、Code.exe 等），再重新打开。旧进程不会自动加载新策略。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
验证是否生效：
Get-ItemProperty -Path "HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem" -Name "LongPathsEnabled"
输出应为 LongPathsEnabled : 1。若提示权限拒绝，请确认 PowerShell 是「以管理员身份运行」。
把项目移到极短英文路径下（比改配置更直接）
即使开了 LongPathsEnabled，C:\Users\YourName\Documents\GitHub\my-app\vendor\... 这种路径仍可能被 PHP 扩展或 IDE 内部逻辑截断。最稳的解法是物理缩短起点。
- 推荐路径：
D:\p\myapp（4 字符前缀 + 项目名）或C:\a（2 字符，注意避开系统保留名） - 避免路径：
C:\Users\中文名\...、C:\Program Files\...、C:\Windows\... - 移动后，在新路径下重新运行
composer install，不要复用旧vendor目录
配合 Composer 配置收尾（防止缓存路径拖后腿）
默认缓存路径（如 %LOCALAPPDATA%\Composer\files\）本身就很长，解压时叠加项目路径，极易突破临界值。需主动重定向：
- 全局缩短缓存：
composer config --global cache-dir "C:/c" - 项目外挂载
vendor（真正脱离项目层级）：composer config vendor-dir "D:/v"，然后确保D:/v目录存在且有写权限 - 临时生效（仅当前终端）：
set COMPOSER_CACHE_DIR=D:\ccache（CMD）或$env:COMPOSER_CACHE_DIR="D:\ccache"（PowerShell） - 跳过高风险阶段：
composer install --no-scripts --no-plugins完成基础解压，再单独跑composer dump-autoload
复杂项目或团队协作中，LongPathsEnabled=1 + D:\p\myapp + vendor-dir 绝对路径组合，基本覆盖所有已知触发点；若仍不稳定，说明环境里混用了旧版 Composer（
