镜像配置总不生效是因为静默失败，必须同时满足三个硬性条件：键名必须为单数repo.packagist、第二个参数必须显式写composer、URL须以https://开头且末尾带/；验证需执行composer config -g repo.packagist，输出应为完整JSON或有效URL字符串，空、null或仍为packagist.org即未写入成功。
镜像配置为什么总不生效
不是 Composer 没反应，是它静默失败了。三个硬性条件缺一不可：repo.packagist（不是 repos.packagist，多一个 s 就彻底忽略）、第二个参数必须是 composer（这是仓库类型声明，漏掉会 fallback 到官方源）、URL 必须以 https:// 开头且末尾带 /（https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌）。
验证是否成功：composer config -g repo.packagist 输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或至少是完整 URL 字符串。如果为空、null 或仍是 https://packagist.org，说明完全没写进去。
常见误操作：
- 在 Windows 上用普通用户执行
composer config -g，但 PHPStudy 或宝塔后台以www用户运行，配置不被读取 - 之前误配过
repos.packagist，没先composer config -g --unset repo.packagist就重试 - Docker 构建中写
RUN composer config -g repo.packagist ...，但基础镜像没初始化全局配置目录，命令静默失败
卡在“Resolving dependencies”怎么办
这不是下载慢，是本地 CPU 在暴力穷举满足 composer.json 所有约束的版本组合——尤其当写了 "*"、"^1.0 || ^2.0" 或 "minimum-stability": "dev" 时，求解器会指数级爆炸。
立即学习“PHP免费学习笔记（深入）”；
关键动作：
- 删掉
"minimum-stability": "dev"—— 稳定版能直接砍掉 80% 的求解时间 - 收紧 PHP 版本约束：
"php": "^8.1"比"php": ">=7.4"少查几百个包的兼容性元数据 - 确保
composer.lock已提交进 Git，并在 CI/部署中始终用composer install（不是update） - 临时禁用 xdebug：
php -d xdebug.mode=off $(which composer) install，它会让解析慢 5–10 倍
缓存目录放错位置会让 install 慢 2–5 倍
默认缓存路径 ~/.composer/cache 若落在机械盘、WSL2 挂载的 Windows 目录、加密卷或 NFS 上，解压 ZIP 包时 I/O 就成瓶颈。
查当前生效值：composer config --global cache-dir
强制迁移到 SSD 路径：composer config -g cache-dir /mnt/ssd/composer-cache
临时测试是否走新路径：COMPOSER_CACHE_DIR=/tmp/composer-cache composer install --dry-run，再看 /tmp/composer-cache 下有没有新文件生成
注意点：
- 缓存目录必须可写，且别挂到低速卷上
- CI、宝塔、systemd 里还是慢？你在终端用
root执行了composer config -g，但它们读的是各自家目录下的~/.composer/config.json - 确认用户身份后，用对应用户重配，例如：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
CI/CD 和 Docker 中必须加的关键参数
本地开发可以容忍慢，但 CI 构建里每秒都算钱。composer install 不带关键参数，等于主动浪费资源。
推荐组合命令：
composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative
各参数作用：
-
--no-dev：跳过require-dev，省掉 30%–60% 时间 -
--prefer-dist：强制下 ZIP 包，避免 Git clone、SSH 认证、分支切换等开销 -
--optimize-autoloader：生成预编译类映射，减少运行时扫描 -
--classmap-authoritative：让自动加载器彻底跳过 PSR-4 发现逻辑——注意：开发机上误用会导致新增类直接报错
CI 脚本中别依赖全局配置，改用临时参数更可靠：COMPOSER_MEMORY_LIMIT=-1 php -d xdebug.mode=off $(which composer) install --no-dev --prefer-dist --no-autoloader --no-scripts
最容易被忽略的是：项目级配置比全局更稳，但要确保 composer.json 的 repositories 数组没被手写覆盖；用 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加 -g）追加，才不会丢私有源。
