ThinkPHP 8.0必须用composer create-project安装，因依赖自动加载、服务发现等机制，手动复制或Git克隆无法初始化结构；需PHP 8.0+（推荐8.1/8.2）并启用fileinfo、mbstring、openssl、pdo扩展，安装后执行php think version和php think run验证。
ThinkPHP 8.0 必须用 Composer 新建项目，不能靠手动复制或 Git 克隆“代替安装”——因为框架依赖自动加载、服务发现、配置合并等机制，只有 create-project 能一次性完成结构初始化和依赖安装。
确认 PHP 环境已就绪
TP8.0 要求 PHP 8.0+（推荐 8.1 或 8.2），且必须启用四项核心扩展：fileinfo、mbstring、openssl、pdo。执行以下两步验证：
- 运行
php --ini，确认 Loaded Configuration File 指向你实际修改的php.ini（不是php.ini-development） - 运行
php -m | grep -E "fileinfo|mbstring|openssl|pdo"（Mac/Linux）或php -m | findstr "fileinfo mbstring openssl pdo"（Windows），确保四者全部列出 - 若缺失某项，打开对应 php.ini，取消
extension=...行前的分号；注意后缀：Windows 用.dll，Linux/macOS 用.so - 改完重启终端再验证——PATH 指向旧 PHP 目录是 Windows 用户最常踩的坑
换国内镜像源（提速防失败）
Composer 默认源在国外，首次使用极易卡在解压或超时。执行一次即可全局生效：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/- 如遇 zlib_decode 错误或长时间卡在 installing dependencies，临时关闭 Windows Defender 实时防护
执行 create-project 创建项目
进入你打算存放项目的目录（如 D:\projects 或 /data/www），运行命令：
立即学习“PHP免费学习笔记（深入）”；
- 标准安装（自动拉最新稳定版 TP8.x）：
composer create-project topthink/think blog→ 生成blog/文件夹 - 指定版本（防意外降级）：
composer create-project topthink/think blog 8.0.12 - 当前目录安装（适合已有空文件夹）：
composer create-project topthink/think .（末尾是英文句点）
⚠️ 注意：目标文件夹必须为空，否则报错 Destination folder already exists and is not empty。
启动并验证项目
进入项目根目录后，快速验证是否成功：
- 查看框架版本：
php think version→ 应输出类似v8.0.12 - 启动内置服务器：
php think run→ 访问 https://www.php.cn/link/f0838b2ebfc6440a474eabdc326bf31a 看到 ThinkPHP 欢迎页即成功 - 不要用
php -S直接跑 public/index.php —— TP8 的路由和中间件依赖think run启动器
