ThinkPHP 6+ 必须用 Composer 安装，因框架底层依赖其自动加载、服务容器和扩展机制；直接解压会导致类找不到、think命令失效等硬性报错，正确方式是执行composer create-project topthink/think=6.3.* .
ThinkPHP 必须用 Composer 安装，源码包解压或 Git 克隆方式在 TP6+ 已不可靠运行。这不是推荐问题，而是框架底层结构决定的——TP6 起彻底依赖 Composer 的自动加载、服务容器和扩展机制，手动复制文件会导致 think 命令失效、类找不到、扩展无法注册等硬性报错。
为什么不能直接解压源码包？
TP6+ 的核心目录 thinkphp/ 不再是“静态框架”，它被设计为 Composer 包（topthink/framework），所有类路径、命名空间映射、服务提供者注册都由 vendor/autoload.php 和 composer.json 驱动。直接解压会缺失：
• vendor/ 下的依赖（如 psr/log、league/container）
• 自动加载规则（composer dump-autoload 生成的映射）
• think 可执行脚本（位于 vendor/bin/think，非根目录下的那个假脚本）
现象：运行 php think run 报错 Class 'think\App' not found 或直接提示 Command "run" is not defined。
正确安装步骤（TP6.3 / TP7 预览版均适用）
确保已安装 PHP ≥ 8.1（TP7 要求）、Composer ≥ 2.5：
- 新建项目目录并进入：
mkdir myapp && cd myapp - 执行安装命令（推荐指定稳定版本）：
composer create-project topthink/think=6.3.* . --ignore-platform-reqs
（--ignore-platform-reqs临时绕过 PHP 版本强校验，调试时可用；生产环境请先升级 PHP） - 安装完成后，立即验证：
php think version应输出类似v6.3.10 - 启动内置服务器：
php think run，访问http://127.0.0.1:8000看到欢迎页即成功
常见配置陷阱与绕过方案
新手最容易卡在两处，且错误信息极其模糊：
立即学习“PHP免费学习笔记（深入）”；
-
Web 服务器根目录配错：Apache/Nginx 必须指向
public/目录，不是项目根目录。配错表现为 404 或直接下载index.php文件。检查点：DocumentRoot /path/to/myapp/public（Apache）、root /path/to/myapp/public;（Nginx） -
数据库配置写在错位置：TP6+ 的数据库配置不在
application/database.php（该文件已废弃），而必须写在config/database.php。写错后Db::table(...)->select()会静默失败或报Connection refused，但实际是配置未加载 -
Windows 下
php think权限问题：若提示Permission denied，不是权限设置问题，而是 Windows 默认不识别vendor/bin/think符号链接。改用php vendor/bin/think或直接php think（Composer 会自动代理）
真正麻烦的从来不是“怎么装”，而是装完发现 php think make:controller 不生效、Db 类调用无响应、或者改了 config/app.php 却完全不生效——这些几乎 100% 指向 Composer 加载链断裂或配置路径认知偏差。动手前，先跑通 php think version 和 php -m | grep pdo，比反复刷新浏览器有用得多。
