推荐使用 composer create-project 安装 ThinkPHP，它自动下载官方包、解析依赖并执行初始化脚本；Git 克隆+composer install 适合定制开发但需手动补全配置；composer require 适用于已有项目轻量集成核心组件。
如果您尝试在本地环境部署 ThinkPHP 框架，但项目初始化失败或提示类未找到，则很可能是未通过 Composer 正确安装框架。以下是多种可靠安装 ThinkPHP 的方法：
一、使用 composer create-project 创建新项目
该方式会自动下载 ThinkPHP 官方包、解析全部依赖、执行初始化脚本（如生成 app.php、清空 runtime 目录），是官方推荐且最稳定的安装路径。
1、确认系统已安装 PHP 7.4+（ThinkPHP 6）或 PHP 8.0+（ThinkPHP 8），并运行 composer --version 验证 Composer 可用。
2、打开终端，切换至目标工作目录（如 /var/www 或 D:\xampp\htdocs）。
立即学习“PHP免费学习笔记（深入）”；
3、执行命令：composer create-project topthink/think tp6（tp6 为项目文件夹名，可自定义）。
4、等待下载与安装完成，进入新生成的目录：cd tp6。
5、检查 runtime/ 目录是否具备写入权限：Linux/macOS 执行 chmod -R 755 runtime/；Windows 用户需确保 Web 服务器进程（如 Apache/IIS）对该目录有修改权限。
二、使用 Git 克隆 + composer install 组合安装
适用于需要基于特定分支开发、参与框架贡献或需手动控制源码版本的场景。此方式不执行自动初始化脚本，需额外补全 vendor 和配置。
1、执行 git clone https://github.com/top-think/think.git tp6，克隆主仓库到本地 tp6 目录。
2、进入目录：cd tp6。
3、运行 composer install 安装依赖（注意：此命令不会触发初始化脚本，app.php 等文件需手动创建或从标准安装中复制）。
4、手动创建 config/app.php（若缺失），或从 vendor/topthink/think/src/config/app.php 复制基础配置。
5、确保 runtime/ 目录存在且可写，否则日志与缓存将无法生成。
三、使用 composer require 在已有项目中引入
适用于已有 PHP 项目需集成 ThinkPHP 核心组件（如命令行工具、路由解析器等），而非完整 MVC 框架结构的轻量集成场景。
1、确保当前目录为已有项目的根目录，且含 composer.json 文件。
2、执行命令：composer require topthink/think（默认安装最新稳定版）。
3、手动创建入口文件 public/index.php，内容需包含 ThinkPHP 启动逻辑，例如：run()->send();。
4、手动建立 app/、config/、route/ 等目录，并填充必要结构文件（参考标准安装目录）。
5、设置 Web 服务器文档根目录为 public/，并启用伪静态支持（Apache 需 AllowOverride All，Nginx 需 try_files $uri $uri/ /index.php?$query_string;）。
