如何解决Composer配置文件权限问题以设置镜像？

本文共计1201个文字，预计阅读时间需要5分钟。

基本原因不是权限不足，而是命令没写对或路径被环境变量影响了。Composer 会根据 `COMPOSER_HOME` 环境变量确定文件存放位置，而不是默认写入 `~/.composer/`。在 Windows 下，它可能去 `%APPDATA%\Composer\config.json`，而在 Linux/macOS 下，默认是 `~/.composer/config.json`。

执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 后，如果 composer config -g repo.packagist 返回空或报错，说明写入失败，常见情况有：

• COMPOSER_HOME 被手动设错（比如指向了只读目录或不存在路径）
• 当前用户对目标目录没有写权限（如 CI 容器里 /root/.composer 目录属主是 root，但构建用的是普通用户）
• 误用了 sudo composer config -g，导致配置写进了 root 的 ~/.composer，但后续命令没用 sudo 运行，就读不到

验证方式：运行 echo $COMPOSER_HOME（Linux/macOS）或 echo %COMPOSER_HOME%（Windows），再检查该路径下 config.json 是否存在、是否可写。不建议手改 JSON，composer config -g 是唯一安全写入方式。