composer镜像配置静默失效主因是命令错误：repo.packagist键名多s、漏-g、缺composertype值或url末尾无/；composer 2.2+已弃用该键名，须改用repositories.packagist.org分步配置，并通过composer diagnose验证repo行是否生效。
镜像配置命令写错，composer config -g repo.packagist 会静默失效
不是所有看起来像配置的命令都真能生效。比如 composer config -g repos.packagist（多一个 s）或 composer config repo.packagist（漏掉 -g），执行后不报错，但查 composer config -g repo.packagist 输出为空或仍是 https://packagist.org/ —— 这说明根本没写进全局配置。
Composer 2.2+ 已弃用旧键名，必须用新版写法：
-
composer config -g repositories.packagist.org composer https://mirrors.aliyun.com/composer/（注意末尾斜杠不能少） - 或仍兼容的旧写法：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（type值composer不可省） - 验证是否真生效：运行
composer diagnose，盯住 “Repo:” 行；再跑composer show -p -vvv | head -5，第一行 URL 必须含mirrors.aliyun.com
composer create-project 卡在 Downloading 或报 could not find package
这不是网络断了，是 Composer 静默 fallback 到了 https://packagist.org/，而这个地址在国内基本不可达。尤其 Windows 用户在 Git Bash 下执行，还可能叠加 proc_open 失败，但错误表现一样——卡住或红字。
立刻止损步骤：
- 按
Ctrl+C中断当前命令 - 手动删掉当前目录下的
vendor/和composer.lock - 执行
composer clear-cache - 改用带镜像参数的临时安装：
composer create-project --repository=https://mirrors.aliyun.com/composer/ topthink/think myapp
项目级 composer.json 里有 repositories 字段，会彻底屏蔽全局镜像
刚 clone 下来的 ThinkPHP 官方模板，常自带过时的 "repositories": [{"type": "composer", "url": "https://packagist.laravel-china.org"}] —— 这个域名早在 2025 年底就已下线，但只要字段存在，全局配置就完全失效。
处理方式分场景：
- 本地开发：直接删掉
composer.json中整个"repositories"区块（保留缩进，别破坏 JSON 格式） - CI/协作环境：用
composer config repo.packagist composer https://mirrors.aliyun.com/composer/自动追加，不覆盖已有私有源 - 紧急调试：加
--repository=https://mirrors.aliyun.com/composer/参数强制走指定源，绕过所有配置文件
装完依赖却访问 500 错误，可能和 composer install 的默认行为有关
ThinkPHP 6 的 post-root-package-install 和 post-autoload-dump 脚本，会在安装时自动清空 runtime/、生成缓存、甚至尝试连接数据库。本地没配 DB 或权限不对时，这些脚本失败会导致 composer install 中断，但 vendor 其实已装好，表面看“成功”，实际入口文件跑不起来。
推荐首次安装加这两个开关：
-
composer install --no-scripts --no-autoloader（跳过所有脚本和 autoload 生成） - 装完再单独跑：
composer dump-autoload -o和php think optimize:route等必要命令 - Web 服务器 root 必须指向
public/目录，且public/index.php必须正确引入vendor/autoload.php
镜像配置本身很简单，真正容易出问题的是缓存残留、JSON 格式错误、路径权限混乱，以及把“配置写了”当成“配置生效了”。每次怀疑镜像失效，先跑 composer diagnose 看 Repo 行，比重装十次更省时间。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
