必须用composer create-project而非require：前者生成含public/、app/、think脚本等完整骨架，后者仅装核心包，缺失入口和初始化逻辑，导致class 'think\app' not found等错误。
ThinkPHP项目不能靠“解压 zip”或composer require凑合启动，必须用composer create-project生成完整项目结构；否则php think命令失效、App::run()找不到入口、路由和中间件全不加载——这不是配置问题，是骨架缺失。
必须用create-project，不是require
ThinkPHP 是一个带完整目录结构（public/、app/、runtime/、think脚本）的框架项目，不是单个可引入的库。
-
composer require topthink/think只会装核心组件，缺public/index.php、think命令脚本、默认中间件注册逻辑，运行直接报Class 'think\App' not found - 正确命令：
composer create-project topthink/think tp8（tp8是项目目录名，可自定） - 指定版本加
@8.0后缀，如topthink/think@8.0；TP6/7/8 均适用此流程 - 别在已有 Laravel/Symfony 项目里硬塞 ThinkPHP —— 自动加载规则、入口生命周期冲突，
App类根本不会被识别
.env配置优先级最高，改了要清缓存
.env文件在create-project时生成，但默认注释掉全部配置项。很多“连不上数据库”“白屏无错误”的问题，根源就在这儿。
-
APP_DEBUG=true必须取消注释，否则所有异常被静默吞掉，只返回500或空白页 - 数据库配置写法是
DB_TYPE=mysql、DB_HOST=127.0.0.1，不是database.type这种嵌套键名 -
.env修改后无需重启 PHP-FPM，但必须手动清空runtime/cache/目录，否则旧配置仍从缓存读取 - 如果
config/database.php里写了数据库参数，但.env也存在同名键，.env会完全覆盖 PHP 配置
Web 服务器根目录必须指向public/
这是最常被跳过的一步，后果严重：既暴露.env和config/等敏感目录，又导致index.php无法加载框架引导文件。
- Apache/Nginx 配置中，
DocumentRoot或root必须设为/path/to/your/project/public，不是项目根目录 - 若误配到项目根，访问
http://localhost/.env可直接下载配置文件，含数据库密码 - 错误日志中常见
require(): Failed opening required '.../thinkphp/base.php'，就是public/index.php找不到引导路径 - Windows 下用 phpstudy 部署时，在“网站管理”里选中项目，点击“根目录”右侧文件夹图标，手动定位到
public子目录
php think命令跑不起来？先查三件事
php think make:controller User报Command "make:controller" is not defined，90%不是拼错命令，而是环境没对齐。
- 确认当前终端所在目录是项目根目录（含
think可执行脚本），不是app/或public/ - Linux/macOS 下若提示
Permission denied，运行chmod +x think补权限 - 运行
php -v和which php，确保 CLI 使用的 PHP 版本与 Web 服务器一致（比如 MAMP 用户容易踩这个坑） - 部分共享主机禁用
exec()，php think会卡住无响应，此时只能改用 Web 路由模拟生成逻辑
真正麻烦的不是初始化步骤本身，而是每个环节都依赖前序动作的完成状态：没用create-project就动不了.env，.env没生效就调不通数据库，数据库不通php think就加载不了命令类——它是个强链式依赖，断一环，全卡住。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
