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 时，求解器会穷举所有可能组合。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 加 --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）导致安装中断，或触发远程元数据查询拖慢整个流程。

• --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 仍会尝试校验它是否存在，然后报错退出。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！