ThinkPHP6 必须通过 composer create-project 安装，因已移除传统 ZIP 解压方式；该命令自动拉取骨架、安装依赖、生成目录结构和配置，直接下载源码或运行 composer install 均无效。
ThinkPHP6 不能用“一键部署”方式安装，它必须通过 Composer 创建新项目，不存在下载 ZIP 包解压即用的“安装”流程。
为什么 composer create-project 是唯一正确入口
TP6 已彻底移除传统下载源码 + 手动配置的方式。它的核心依赖（如 topthink/framework）、自动加载、命令行工具（think）都绑定在 Composer 的项目初始化流程中。
- 直接下载 GitHub 源码 zip 或 clone 仓库，缺少
vendor/和自动加载映射，运行会报Class 'think\App' not found -
composer install在空目录下会失败，因为没有composer.json - 必须用
create-project命令，它会：拉取官方 skeleton、安装全部依赖、生成正确的目录结构和基础配置
实际执行命令与关键参数说明
在终端中运行以下命令（确保已安装 PHP 7.2+ 和 Composer）：
composer create-project topthink/think tp6
这条命令等价于：
立即学习“PHP免费学习笔记（深入）”；
- 从
https://packagist.org/packages/topthink/think下载最新稳定版 skeleton 项目 - 解压到本地
tp6/目录 - 自动执行
composer install安装所有依赖（包括topthink/framework、psr/log等） - 生成可直接运行的
public/index.php入口
如果想指定版本（比如 v6.3.3），加 @ 后缀：
composer create-project topthink/think tp6@6.3.3
安装后必须做的三件事
骨架项目生成后，不是“部署完成”，还有几个硬性步骤不走完就跑不起来：
-
php think run启动内置服务器（端口默认 8000），访问http://127.0.0.1:8000看欢迎页；别直接用浏览器打开public/index.php，那会出错 - 检查
runtime/目录是否可写（Linux/macOS 下常需chmod -R 755 runtime；Windows 一般无问题） - 确认
.env中的APP_DEBUG = true已开启，否则错误不显示，调试寸步难行
常见报错及对应原因
遇到这些提示，基本都是跳过了上面某一步：
-
Could not find package topthink/think→ Composer 镜像源失效，临时切回官方源：composer config -g repo.packagist composer https://packagist.org -
Class 'think\Container' not found→ 运行了php public/index.php而非php think run，或未执行create-project直接复制了代码 - 空白页 + 无报错 →
APP_DEBUG = false且日志关闭，立刻改.env并清空runtime/log/下文件
TP6 的“部署”本质是构建一个 Composer 项目，不是拷文件。路径、权限、环境变量、启动方式，四个点缺一不可。
