thinkphp依赖安装失败90%是环境、镜像或残留文件问题：需删vendor和composer.lock、清缓存、切阿里云镜像、用create-project命令安装，并确保public/index.php正确引入autoload.php且访问路径指向public目录。
ThinkPHP依赖包安装失败，90%不是框架本身的问题，而是环境、镜像或残留文件没处理干净。不用重装PHP，也不用反复删项目，按下面几步操作，基本5分钟内能跑通。
先清缓存和删残留
vendor目录和composer.lock是旧依赖规则的“快照”，不清理就容易版本冲突或路径错乱。 - 删除项目根目录下的 vendor/ 文件夹和 composer.lock 文件 - 运行 composer clear-cache 清掉本地缓存（尤其之前换过镜像或失败多次） - Windows 用户避免用 Git Bash 或 WSL 执行，改用 CMD 或 PowerShell，防止 proc_open 权限异常确认PHP环境达标
ThinkPHP 6 要求 PHP ≥ 7.2.5（推荐 7.4+），TP8 则必须 PHP ≥ 8.0.2；缺扩展比版本低更隐蔽，常静默失败。 - 运行 php -v 查版本 - 运行 php -m | grep -E "(json|mbstring|xml|curl|openssl|fileinfo|pdo)"（Linux/macOS）或 php -m（Windows）确认关键扩展已启用 - Windows 用户务必执行 php --ini，看 CLI 模式加载的是哪个 php.ini，别只改了 Apache 的配置切对镜像源再重装
国内直连 packagist.org 基本不可用，“timeout”“could not find package”八成是镜像没生效。 - 全局设置阿里云镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：composer config -g repo.packagist 输出里要有该 URL - 安装必须用：composer create-project topthink/think myapp（TP6/TP8 都适用） - 别用 composer require topthink/think——它只装代码进 vendor，不生成 app/、public/ 等结构，后续必报 Class 'think\App' not found装完仍报错？重点查入口和自动加载
安装成功 ≠ 能运行。常见问题集中在路径错、autoload 没引入、或命名空间映射丢失。 - 打开 public/index.php，第一行必须是：require __DIR__ . '/../vendor/autoload.php';（少一个点或多一个斜杠都会失效） - 浏览器必须访问 http://localhost/myapp/public/，不能访问根目录（如 http://localhost/myapp/） - 命令行进项目根目录运行 php think，能输出命令列表才说明 autoload 正常；报错则检查 vendor/autoload.php 是否真实存在、是否被 open_basedir 限制不复杂但容易忽略。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
