改缓存路径能提速composer，因其默认缓存目录若位于机械硬盘、远程盘或容器临时文件系统会导致读写慢；换至ssd/nvme本地路径后，解压校验耗时降30%–60%，是网络正常但下载卡顿的常见物理瓶颈。
为什么改缓存路径能提速
Composer 默认把包缓存存在 ~/.composer/cache，如果这个目录在机械硬盘、远程挂载盘或容器临时文件系统里，每次读写 ZIP 包和元数据都会变慢。换成 SSD 或本地 NVMe 路径后，缓存命中时解压+校验耗时能降 30%–60%。这不是“锦上添花”，而是当 composer install 卡在 Downloading 但网络其实正常时，最常被忽略的物理瓶颈。
怎么安全修改 cache-dir 配置
执行这条命令即可生效（注意路径末尾不能有斜杠）：
composer config -g cache-dir /mnt/ssd/composer-cache
- 路径必须真实存在且当前用户有读写权限，否则后续所有命令会报
file_put_contents(): failed to open stream - 不要用
~符号，composer不展开它；写绝对路径，比如/home/you/composer-cache - 改完立刻验证：
composer config -g cache-dir输出应为刚设的路径，不是空或默认值 - 旧缓存不会自动迁移，需要手动
cp -r ~/.composer/cache/* /mnt/ssd/composer-cache/（可选，但推荐）
cache-dir 和其他缓存配置的关系
cache-dir 是顶层目录，它下面还分 files、repo、vcs 子目录。你只改这一个，其余结构自动保持。但要注意几个联动点：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
cache-files-ttl控制files/下 ZIP 包过期时间，默认 6 个月；若你磁盘小，可设成2592000（30 天） -
cache-files-maxsize限制整个cache-dir占用，建议设为"1G"，避免 SSD 空间被撑满 -
cache-read-only在 CI 容器中设为true可防写冲突，但本地开发别开，否则新包下不来
容易被忽略的权限与清理陷阱
换路径后最常出问题的是：命令跑一半卡住、提示 Permission denied、或者 composer clear-cache 清的还是旧路径。关键检查点：
- 运行
ls -ld /mnt/ssd/composer-cache，确保属主是当前用户，且有rwx权限 -
composer clear-cache只清cache-dir指向的位置，不会碰旧路径；如果之前缓存还在~/.composer/cache，得手动删掉 - 某些 IDE（如 PHPStorm）会缓存 Composer 配置，改完后重启 IDE 或清其内部 Composer 配置缓存
- 如果用了 Docker，宿主机路径映射进容器时，要确保容器内用户 UID 和宿主机一致，否则写入失败
改缓存路径本身很简单，但真正起效的前提是路径可写、空间够用、且没被其他机制（如 IDE、CI 挂载逻辑、容器用户映射）悄悄绕过。多数“改了没提速”案例，问题不在 Composer，而在路径实际是否真的被用上了。
