根本原因是packagist官方源国内直连不稳定，正确命令为composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，验证需输出该url且执行composer clear-cache和composer show dcat/laravel-admin确认。
为什么 composer require dcat/laravel-admin 总卡住或超时
根本原因是 Packagist 官方源（https://packagist.org）在国内直连不稳定，尤其下载 dcat/laravel-admin 及其依赖（如 laravel/framework、symfony/*）时容易触发 500 或 timeout。这不是 Dcat Admin 本身的问题，而是网络链路导致的包拉取失败。
切换阿里云镜像的正确命令和验证方式
执行以下命令即可全局生效，无需修改项目级配置：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：
- 运行
composer config -g repo.packagist，输出应为https://mirrors.aliyun.com/composer/ - 执行
composer show dcat/laravel-admin，如果能快速列出版本信息，说明镜像已生效 - 注意：不要用
composer config repo.packagist ...（缺-g），那是项目级配置，对全局安装无影响
安装前必须清理缓存并检查 PHP/Laravel 版本
即使换了镜像，旧缓存或版本不兼容仍会导致 composer require 报错（例如 “Your requirements could not be resolved”）。必须做这两件事：
- 运行
composer clear-cache清掉可能损坏的包缓存 - 确认当前环境满足最低要求：
php -v≥ 7.2.5（推荐 8.0+），php artisan --version显示 Laravel ≥ 8.x - 若 Laravel 版本过低（如 6.x 或 7.x），需先升级框架，否则
dcat/laravel-admin会因依赖冲突拒绝安装
安装后运行 admin:install 失败的常见原因
php artisan admin:install 报错（如 “Class 'Dcat\Admin\Admin' not found” 或迁移失败），往往不是镜像问题，而是：
- 未执行
composer dump-autoload—— 换镜像安装后，Autoloader 可能未刷新，补一句再试 - 数据库未就绪或
.env中DB_*配置错误 ——admin:install会运行迁移，必须能连上 MySQL/SQLite - Node.js 缺失或版本太低（
npm -v
真正卡在安装环节的，90% 是这三件事没做全，而不是镜像没切对。
