Composer怎么在跨系统迁移时重置缓存配置-composer-PHP中文网

必须运行composer config --global cache-dir确认真实路径，它按环境变量→全局config→默认路径优先级生效，输出为空或报错说明未正确配置，windows可粘贴%appdata%\composer\cache验证，linux/macos用du -sh $(composer config --global cache-dir)查看大小。

composer怎么在跨系统迁移时重置缓存配置

跨系统迁移 Composer 时，缓存配置不会自动适配新环境，必须手动重置；否则旧路径（如 ~/.composer/cache）在 Windows 上可能被解析为 Cygwin home，Linux/macOS 上可能因 $COMPOSER_HOME 变量缺失而 fallback 到错误位置，导致缓存写入失败或静默降级到默认路径。

怎么确认当前生效的缓存路径？

别信文档写的默认值，也别猜 ~/.composer/cache 是否还在用。真实路径由三者优先级决定：环境变量 → 全局 config → 默认路径。验证方式只有一种：

运行 composer config --global cache-dir —— 输出为空、null 或报 Key not found，说明全局没设或被忽略
运行 composer diag | grep "Cache directory" —— 这行输出才是 Composer 实际写入的位置，哪怕你刚改过 config
Windows 用户可直接把 %APPDATA%\Composer\Cache 粘贴进资源管理器地址栏，右键“属性”看大小；Linux/macOS 用 du -sh $(composer config --global cache-dir)

为什么不能直接拷贝旧 `auth.json` 或改 JSON 文件？

手改 ~/.composer/config.json 或 ~/.config/composer/config.json 极易出错，且 Composer 静默忽略整个文件而不报错：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

多一个逗号、少一个引号、用了中文标点、BOM 头、路径含 ~ 符号，都会导致 JSON 解析失败
Git Bash 下编辑 %APPDATA% 路径，实际写入的是 Cygwin home 目录下的文件，新 PowerShell 根本读不到
$COMPOSER_HOME 若被设过，它会强制接管配置路径，且必须是绝对路径（~/composer 不合法）

重置缓存路径的正确操作顺序

迁移后第一件事不是清缓存，而是确保新环境用上正确路径，避免后续所有命令都写错地方：

先创建目标目录：mkdir -p /data/composer-cache（Linux/macOS）或 mkdir "C:\Users\YourName\AppData\Local\Composer\Cache"（Windows）
再设权限：Linux/macOS 执行 chmod 755 /data/composer-cache；Windows 右键目录 → “属性” → “安全” → 确保当前用户有“完全控制”
最后写入配置：composer config --global cache-dir /data/composer-cache（Linux/macOS）或 composer config --global cache-dir "C:\Users\YourName\AppData\Local\Composer\Cache"（Windows，必须加英文双引号）
验证是否生效：composer config --global cache-dir 必须输出你刚设的完整路径；再跑一次 composer clear-cache，观察日志清理的是否是该路径

要不要搬旧缓存？哪些能搬、哪些必须删？

缓存不是全盘复制就完事。VCS 缓存（cache/vcs/）单个裸仓库动辄 500 MB 以上，且高度依赖 Git 配置、SSH 密钥、host 指纹，跨系统几乎无法复用：

建议只搬三类：cache/files/（ZIP/TAR 包，离线安装必需）、cache/repo/（元数据，加速首次 update）、cache/archived/（Composer 2.5+ 新增归档缓存）
禁用 VCS 缓存更省事：composer config --global cache.vcs false，避免首次 install 重新 clone 私有仓库
搬完别忘了清旧缓存：rm -rf ~/.composer/cache（Linux/macOS）或手动删 %APPDATA%\Composer\Cache（Windows），防止残留路径干扰

最常被忽略的一点：跨系统迁移后，cache-dir 配置本身不解决认证问题。私有包仍需重新配置 auth.json 凭据，且不能直接拷贝 token——GitLab 或 Nexus 的 token 往往绑定 IP 或 UA，新机器必须用 composer config --global http-basic.example.com token user 重置，否则 composer install 会在拉取私有包时卡住或报 401。