Composer config -g repo.packagist 命令总不生效的根本原因是漏掉三个硬性要求：键名必须为单数 repo.packagist（不能写成 repos.packagist 或 packagist.org）、第三参数必须显式指定 type 值 composer、URL 必须为 HTTPS 且末尾带斜杠 /；任一缺失均导致静默失败且无报错，验证需运行 composer config -g repo.packagist 输出完整 JSON 如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 命令为什么总不生效
根本不是网络或镜像地址问题，而是命令漏了三个硬性要求：repo.packagist（不能写成 repos.packagist 或 packagist.org）、composer（这是 type 值，不是可选参数）、https://mirrors.aliyun.com/composer/（末尾斜杠 / 缺不得，HTTP 会被 Composer 2.0+ 拒绝）。漏任一要素都会静默失败，且无报错。
验证是否写入成功，直接运行：composer config -g repo.packagist
正确输出应为类似：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
若为空、null 或报错，说明没写对。
全局配置写进了 root 用户目录，但 PHP 进程读不到
执行 sudo composer config -g repo.packagist ... 会把配置写进 /root/.composer/config.json，而 Web 服务（如 nginx 下的 www-data）或 CLI 用户根本不会读这个路径。结果就是你本地 whoami 看着配好了，php -r 'var_dump(composer);' 却仍走官方源。
安全做法是：
• 先确认当前用户：whoami 和 ls -ld ~（确保 $HOME 可写）
• 绝对不用 sudo 执行 config -g，除非你明确要配 root
• 若需给 Web 用户（如 www-data）用，改用系统级配置：/etc/composer/config.json（Composer 2.2+ 支持），并设权限：sudo chmod 644 /etc/composer/config.json
项目级配置比全局更可靠，尤其适合 CI 和团队协作
全局配置看似省事，但极易被覆盖：只要项目根目录下 composer.json 含 "repositories" 字段（哪怕只是 "packagist.org": false），全局镜像就彻底失效。CI 流水线跑在 runner 用户下，也常因用户上下文不一致导致行为漂移。
部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...
推荐做法：
• 进项目根目录，运行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）
• 它会自动在 composer.json 顶层写入 "repositories" 对象，key 固定为 "packagist"
• 若项目已有 "repositories" 数组，别手动编辑——用命令追加，避免误删私有源
• 此配置可提交 Git，所有人拉代码后行为一致
换源后依然卡在 “Resolving dependencies”？和镜像无关
镜像只加速下载阶段（Downloading），不参与依赖解析。如果你发现 composer update 长时间停在 Resolving dependencies，基本与镜像源无关，问题出在本地环境或 composer.json 写法上：
• "php": "^7.4 || ^8.0" 这类宽泛约束会让 Composer 尝试大量版本组合
• require-dev 里塞太多未锁定的工具包（如 "phpunit/phpunit": "dev-main"）
• 大量 dev- 分支依赖或未指定 minimum-stability
• PHP 版本或扩展缺失（如缺 mbstring），旧版 Composer 不报具体错，只卡住
临时验证：删掉 vendor 和 composer.lock，再用 composer install --no-plugins --no-scripts 看是否仍卡——如果卡，问题就在解析逻辑本身。
