thinkphp 6.0 必须通过 composer create-project 安装，不可用 require 或 zip 解压；需指定稳定版本（如 ^6.1）、配置国内镜像、web 根目录设为 public/、runtime/ 可写且 .env 置于项目根目录。
ThinkPHP 6.0 必须通过 Composer 安装，不能直接下载 ZIP 包解压使用——这是所有踩坑的起点。很多问题其实不是框架本身的问题，而是安装环节没走对路子：比如用 composer require 替代 create-project、没进对目录、镜像没配、权限或路径设错。下面这几个关键环节，几乎覆盖了 90% 的新手卡点。
必须用 create-project，别 hand-require
很多人看到“安装 ThinkPHP”，第一反应是 composer require topthink/think，结果装完只有 vendor/，没有 app/、public/、think 命令脚本，运行就报 Class 'think\App' not found 或 Failed opening required 'base.php'。
-
正确命令：
composer create-project topthink/think tp6-demo - 这个命令会拉取官方项目模板（含完整目录结构+自动加载配置+入口文件），不是只下个库
- 加版本号可指定旧版，例如：
composer create-project topthink/think tp6-demo "6.0.2" - 网络慢时加
--prefer-dist强制用压缩包，避免 Git 克隆卡住
镜像和网络问题要提前处理
国内直连 Packagist 或 GitHub 极易超时、中断、弹 Token 提示。不配镜像，大概率安装失败或耗时几十分钟。
- 推荐阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 若提示 SSL 错误，临时关闭安全限制：
composer config -g secure-http false - 遇到 GitHub Token 报错？去 GitHub 新建 Personal Access Token，勾选
repo权限，再执行：composer config --global github-oauth.github.com YOUR_TOKEN - 装一半中断？删掉目标文件夹，清缓存：
composer clear-cache，再重试
目录、权限与服务器配置三连查
项目跑起来了，但访问空白页、404、500 或提示 “maintenance mode”，往往不是代码问题，而是环境没配好。
-
Web 根目录必须指向
public/，不是项目根目录；否则路由失效、.env可能被直接下载 -
runtime/目录需可写（Windows 下一般默认 OK；Linux/macOS 需chmod -R 755 runtime或chown -R www-data:www-data runtime） -
检查
config/app.php中'debug' => true，否则错误不显示，只看到维护页 - 快速验证是否装对：
php think version应输出v6.x.x；若提示Command "version" is not defined，说明不是用create-project装的
多应用模式不是默认内置，要单独引入
TP6.0 默认是单应用结构。想用多应用（如 app/admin、app/api），不能靠改配置开关，得手动加扩展包。
- 进入项目根目录，执行：
composer require topthink/think-multi-app - 安装成功后，删除原有
app/controller/目录（防止冲突） - 多应用入口由
public/index.php自动识别，无需额外配置，但需确保路由定义在对应应用的route/下 - 注意：部分旧镜像源（如 phpcomposer.com）已停用，若报错，先执行
composer config -g --unset repos.packagist再换阿里镜像
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
