ThinkPHP5安装失败主因是环境问题而非命令错误：90%卡在权限、网络、版本或路径环节，需依次检查目录写权限、镜像源可用性、PHP版本及扩展、项目路径规范性，并确认vendor/autoload.php是否真实生成。
直接说结论：ThinkPHP5安装命令失败，90%不是命令写错了，而是环境卡在权限、网络、版本或路径这四个环节上。
composer create-project 报 Permission denied
这是 Linux/macOS 下最常遇到的错误，典型报错是 [ErrorException] mkdir(): Permission denied。它根本不是 ThinkPHP 的问题，而是当前用户对目标目录没写权限。
- 用
ls -ld ./检查当前目录权限，确认是否属于你当前用户 - 别用
sudo composer create-project—— 这会导致后续 vendor 目录属主混乱，运行时反而报 autoload.php 找不到 - 正确做法是改目录归属：
chown -R $USER:$USER /path/to/your/project，再重试 - 如果是在宝塔或小皮面板里操作，确保网站根目录（如
/www/wwwroot/tp5）已设为可写，且 PHP 运行用户（如www）有读取权限
composer create-project 无反应或只输出版本号
输入命令后没下载、没报错，只返回 Composer version 2.x.x —— 这说明命令根本没执行，因为漏掉了项目名参数。
- 错误写法：
composer create-project topthink/think（缺项目目录名） - 正确写法：
composer create-project topthink/think myapp，其中myapp是新建的项目文件夹名，不能省略 - 如果想指定版本，必须加
@后缀，例如：composer create-project topthink/think myapp@5.1.40；不加则默认拉最新兼容版 - Windows 下路径含空格或中文也容易静默失败，建议项目路径全英文、无空格
require thinkphp/base.php failed 或 autoload.php not found
项目目录有了，但访问 public/index.php 就报 require(): Failed opening required '.../vendor/autoload.php'，说明 Composer 安装中途失败或被跳过。
立即学习“PHP免费学习笔记（深入）”；
- 先确认
vendor/目录是否存在，以及里面有没有autoload.php；没有就代表依赖根本没装上 - 常见原因是镜像源不可达，国内务必换源：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果之前执行过 install 或 update 卡住过，缓存可能损坏，运行
composer clear-cache再重试 - Git 克隆方式安装（非 create-project）时，
thinkphp子模块常被忽略，必须手动执行git submodule update --init
PHP 版本或扩展缺失导致安装中止
Composer 能跑，但 install 过程中抛出类似 Your requirements could not be resolved，或提示 extension missing，本质是环境不达标。
- ThinkPHP5.0+ 要求 PHP ≥ 5.6，但实际推荐 PHP 7.2–7.4；PHP 8.0+ 需用 TP5.1.40+ 或升级到 TP6
- 检查必需扩展是否启用：
pdo_mysql、mbstring、openssl、curl，缺一不可 - 宝塔用户可在「软件商店 → PHP 设置 → 安装扩展」里勾选；Linux 命令行可用
php -m | grep -E "pdo|mbstring"快速验证 - 扩展开了但 still 报错？重启 PHP 服务（如
systemctl restart php-fpm或宝塔面板内点「重启」）
真正卡住的地方，往往不在 ThinkPHP 文档里写的“下一步”，而在你没意识到的当前 shell 用户、PHP 进程用户、web server 用户三者权限是否一致，以及 Composer 是否真的把 vendor 写进去了——先盯死 vendor/autoload.php 这个文件存不存在、能不能被 public/index.php 正确 require 到，比反复重装快得多。
