ThinkPHP 8 安装慢主因是 Composer 默认使用国外源，需执行 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 配置全局镜像，并运行 composer clear-cache 清缓存，再配合 --stability=stable --remove-vcs --no-dev --optimize-autoloader 等参数安装。
ThinkPHP 8 安装慢，90% 是 Composer 在国外源上卡住或反复 fallback，不是你网络差，是默认配置没调对。
composer config -g repo.packagist 必须加 -g
不加 -g，composer config repo.packagist composer https://mirrors.aliyun.com/composer/ 只改当前项目的 composer.json，新项目还得重配。真正生效的是全局配置，写入 ~/.composer/config.json，所有后续 composer install 和 create-project 都走阿里云镜像。
- 正确命令：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否成功：
composer config -g repo.packagist，输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}（注意：必须是 JSON 对象，不是字符串） - 换源后务必清缓存：
composer clear-cache，否则旧缓存仍指向packagist.org - 禁用 fallback 到官方源防超时：
composer config -g repos.packagist false
composer create-project 要带参数，别裸跑
直接 composer create-project topthink/think tp8 很容易拉到不稳定分支、卡在元数据解析阶段，尤其在宽泛版本约束（如 "^8.0"）叠加 @dev 时，求解器会穷举所有可能组合。
- 加
--stability=stable锁定稳定版，避免意外拉到dev-main - 加
--remove-vcs清掉 vendor 里所有.git，防止后续 Git 冲突 - 别加
-n（no-interaction），TP8 初始化要生成.env并提示设置APP_DEBUG，跳过会导致调试关闭、错误不显示 - 完整推荐命令：
composer create-project topthink/think tp8 --stability=stable --remove-vcs
生产部署必须加 --no-dev 和 --optimize-autoloader
TP8 的 composer.lock 默认包含大量 require-dev 依赖（如 phpunit/phpunit、fakerphp/faker），这些在服务器上不仅没用，还常因扩展缺失（如 ext-xdebug）导致安装中断，或触发远程元数据查询拖慢整个流程。
立即学习“PHP免费学习笔记（深入）”；
-
--no-dev：跳过所有开发依赖，省下 40%+ 时间 -
--optimize-autoloader（或--classmap-authoritative）：生成高效类映射，避免运行时文件扫描 - CI/CD 或首次部署可进一步加：
--no-scripts --no-autoloader --prefer-dist，装完再单独跑composer dump-autoload -o - Windows 下还要关 Xdebug：
php -d xdebug.mode=off composer install ...，Xdebug 会让 Composer 解析慢 5 倍以上
ThinkPHP 项目里别留 @dev 和 prefer-stable: false
检查项目根目录 composer.json，删掉所有显式出现的 "dev-master"、"@dev"、"dev-develop"；确认 "minimum-stability" 是 "stable"，不是 "RC" 或 "beta"。
- TP8 生态常见
"topthink/framework": "^6.3"这类宽泛约束，再叠上@dev，Composer 求解器会反复查远程 tag，一卡十几秒 - 推荐锁定小版本：
"topthink/framework": "^8.0.0"，避免自动升到未经充分测试的补丁版 - 别在
composer.json里写"prefer-stable": false，这等于主动放弃稳定性保障
最易被忽略的一点：换源后不 clear-cache，或用了 --no-dev 却忘了删掉 require-dev 里的 ext-xdebug 声明——Composer 仍会尝试校验它是否存在，然后报错退出。
