thinkphp 8.0 在 windows 上安装失败主因是 php 扩展缺失、composer 源被阻断或 web 根目录未指向 public；需验证 php ≥ 8.0.2 及六大扩展启用，换阿里云镜像并清缓存，用 --stability=stable 创建项目，web 服务器根目录必须设为 tp8/public。
在 Windows 10 或 11 上用 Composer 安装 ThinkPHP 8.0 时，执行命令后卡住不动、报错“Connection timed out”、提示“Your requirements could not be resolved”，或安装完访问 public/index.php 显示白屏——这些问题几乎都不源于你操作失误，而是 Composer 在下载阶段被阻断、PHP 平台约束未对齐、或 Web 入口路径配置错误导致的。
确认 PHP 环境是否真正就绪
这一步必须做在安装前。ThinkPHP 8.0 明确要求 PHP ≥ 8.0.2，且 CLI 模式下必须启用 openssl、mbstring、json、curl、fileinfo、ctype 六个扩展。仅靠 php -v 看到版本号不够，要验证 CLI 实际加载情况：
打开 PowerShell（不是 Git Bash 或 WSL），运行：
php -v → 确认输出为 PHP 8.0.2 或更高（如 8.2.15）
php -m | findstr /i "openssl mbstring json curl fileinfo ctype" → 缺任一关键词即失败根源
若缺 fileinfo，去 php.ini 中取消 extension=php_fileinfo.dll 前的分号；若缺 openssl，同时检查 extension_dir 是否指向正确的 ext 目录，且 extension=php_openssl.dll 已启用。改完 php.ini 后必须重启终端，否则 php -m 仍显示旧状态。
换阿里云镜像并清空缓存
国内直连 packagist.org 几乎必然超时，这不是网速问题，是路由策略导致的连接中断。别试三次再换源，直接执行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
然后立刻清缓存：
composer clear-cache
注意：如果之前安装失败过，当前目录下可能残留空的 vendor 文件夹或损坏的 composer.lock，此时不删干净会干扰后续解析。删掉整个项目文件夹再开始下一步更稳妥。
执行带参数的 create-project 命令
不要只输 composer create-project topthink/think myapp。ThinkPHP 8 默认拉取的是 dev-main 分支，不稳定且文档不同步。必须加参数锁定稳定版并规避 Git 冲突风险：
① 打开 PowerShell，cd 到你的网站根目录（如 D:\www）
② 运行：
composer create-project topthink/think tp8 --stability=stable --remove-vcs
③ 等待完成，过程中终端不会显示实时进度条，但光标会持续闪烁——这是正常行为；若超过 6 分钟无任何输出，才需 Ctrl+C 中断并检查镜像是否生效
这个命令会生成完整结构，包括 public/ 入口目录和 .env 配置文件。它不会初始化 Git 仓库，避免你后续 push 时误传 vendor 里的 .git。
Web 服务器必须指向 public 目录
ThinkPHP 8 不允许从项目根目录直接访问 index.php，所有请求必须经由 public/index.php 引导。如果你用的是 phpstudy、小皮、XAMPP 或自己配的 Apache/Nginx，务必把网站根目录设置为 tp8/public，而不是 tp8。
例如在 phpstudy 中添加站点时，“网站目录”路径应填：
D:/www/tp8/public
若填成 D:/www/tp8，访问会直接 404 或白屏，且错误日志里看不到明确提示——这是最常被忽略的部署环节。
验证安装是否真成功
方法一：运行内置服务
cd tp8 → php think run
看到 Starting HTTP server on http://127.0.0.1:8000/ 并能正常打开页面，说明 vendor 加载、自动加载、路由全部就位。
方法二：检查关键文件是否存在
确认 tp8/vendor/autoload.php 存在
确认 tp8/public/index.php 第一行是 require __DIR__ . '/../vendor/autoload.php';
如果 php think run 报 Class 'think\App' not found，说明 vendor 没生成成功或 autoload.php 路径引用错误，此时不要重跑 create-project，先删掉整个 tp8 文件夹，再用带 --verbose 的命令重装：
composer create-project topthink/think tp8 --stability=stable --remove-vcs --verbose
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
