改 Composer 缓存路径是为解决磁盘空间不足、I/O 性能瓶颈和 Windows 路径长度超限三大问题；需确保目标路径存在、有读写权限，禁用波浪号，CI/CD 中须统一挂载路径以保障缓存命中。
改 Composer 缓存路径不是为了“显得专业”，而是解决三个真实问题：磁盘空间不足、I/O 性能瓶颈、路径长度超限。默认缓存位置在用户主目录下，对 CI/CD、Docker、Windows 开发者尤其不友好。
缓存写入失败或报错 file_put_contents
常见错误是 file_put_contents(/path/to/cache/repo/https---packagist.org/packages.json): failed to open stream。根本原因不是权限不够，而是路径不存在或父目录没创建。
- Composer 不会自动递归创建缓存路径的全部层级，
composer config --global cache-dir /data/composer-cache必须确保/data/composer-cache已mkdir -p且当前用户有读写权限 - 别用
~，比如~/cache—— Composer 不解析 shell 波浪号，会当成字面路径写入配置，后续所有操作都失败 - Linux/macOS 下注意 SELinux 或 containerd 的挂载限制；Docker 中若挂载
/data/composer-cache，需确认该路径在宿主机已存在且 uid/gid 匹配
CI/CD 构建变慢或缓存失效
CI 环境里缓存没命中，90% 是因为缓存路径没对齐。默认 ~/.composer/cache 在容器中每次都是新家目录，等于没缓存。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须显式设置统一路径，例如
composer config --global cache-dir /tmp/composer-cache，再在 CI 配置中持久化挂载/tmp/composer-cache - 只挂载
cache/files子目录即可，cache/repo和cache/vcs可不挂（元数据和 VCS 缓存体积小、更新频繁，挂了反而容易因镜像源变更导致冲突） - 缓存 key 应基于
composer.lock内容哈希，而非时间戳——否则 lock 文件不变时，缓存才真正复用
Windows 路径过长触发 File path too long
不是 Composer 本身的问题，是 Windows 默认 MAX_PATH=260。深层嵌套的 vendor/ + 默认缓存路径（如 %APPDATA%\Composer\cache\files\...）叠加后极易超限。
- 最快解法：把缓存挪到短路径，例如
composer config --global cache-dir C:\c，配合composer config vendor-dir C:\v - 不要依赖开启 LongPathsEnabled 就万事大吉——某些 PHP 扩展（如 xdebug）或旧版 Git for Windows 仍可能触发截断
- 符号链接（
mklink /D C:\p\myproj D:\long\path\to\project）比改注册表更可控，且不影响其他项目
缓存路径本身不决定性能，但它是所有缓存策略生效的前提。路径设错，cache-files-ttl、cache-vcs-ttl 全部归零；路径不可写，clear-cache 也清不掉脏数据。动手前先跑一遍 composer config --global cache-dir 确认真实路径，比反复重装 Composer 省半小时。
