ThinkPHP用Composer安装报错90%是环境、镜像或残留问题：需确认PHP版本（TP6≥7.2.5，TP8≥8.0.2）及扩展启用，切阿里云镜像并清缓存，删除vendor和composer.lock后重装，Windows用户须修复Composer缓存目录权限。
一、先确认PHP环境是否真达标
ThinkPHP 6要求PHP ≥ 7.2.5（推荐7.4+），TP8则必须≥8.0.2。很多人以为php -v显示的是8.0，实际运行命令时调用的却是旧版本——尤其Wamp/XAMPP/PhpStudy用户，环境变量没更新或CLI和Web用的php.ini不同，就会静默失败。
- 在CMD/PowerShell里执行php -v，看输出是否符合要求
- 再执行php -m | findstr /i "pdo mbstring json curl openssl xml"（Windows）或php -m | grep -E "(pdo|mbstring|json|curl|openssl|xml)"（Linux/macOS），缺任何一个都可能报Class not found或解析失败
- Windows用户务必运行php --ini，确认CLI模式加载的是哪个php.ini，并在里面启用对应extension（比如去掉;extension=mbstring前面的分号）
二、镜像没切对或缓存已损坏
国内直连packagist.org基本不可用，报错常是“Connection timed out”“failed to open stream”或“could not find package”，本质是Composer悄悄fallback回了默认源。
- 先清缓存：composer clear-cache
- 再切镜像：Composer 2.2+要用新键名，执行composer config -g repositories.packagist.org composer https://mirrors.aliyun.com/composer/（注意末尾斜杠不能少）
- 验证是否生效：composer diagnose，盯住“Repo:”那一行，域名必须是mirrors.aliyun.com；再跑composer show -p -vvv | head -5，第一行URL也得匹配
- 如果还不行，临时换源安装：composer create-project --repository=https://mirrors.huaweicloud.com/composer/ topthink/think myapp
三、删干净再重来，别信“看似成功”
很多报错其实发生在安装中途静默失败：目录非空、vendor没生成全、autoload.php路径错位，结果浏览器一访问就白屏或Class not found。
- 安装前确保目标文件夹是空的；装完立刻检查有没有vendor/和public/index.php
- 手动删掉项目根目录下的vendor/和composer.lock（它们是旧规则的载体，不清就容易冲突）
- 打开public/index.php，第一行必须是：require __DIR__ . '/../vendor/autoload.php';（少一个点、多一个斜杠都会失效）
- 终端进项目根目录，运行php think，能输出命令列表说明自动加载正常；报错就说明vendor/autoload.php根本没被引入
四、Windows用户特别注意权限问题
在Windows下，Composer默认缓存路径%APPDATA%\Roaming\Composer\Cache经常对当前用户没有写入权限，导致clear-cache报“Access is denied”，后续所有操作都连锁失败。
立即学习“PHP免费学习笔记（深入）”；
- 执行composer config --global cache-dir确认路径，再尝试composer clear-cache，若报错就坐实是权限问题
- 推荐用命令行修复（管理员身份打开PowerShell）：icacls "$env:APPDATA\Roaming\Composer\Cache" /grant "$env:USERNAME:(OI)(CI)F" /t
- 更省事的办法：重设缓存路径到用户目录下：composer config -g cache-dir "%USERPROFILE%\composer-cache"，然后手动创建该文件夹
- 别用Git Bash或WSL执行Composer命令，改用CMD或PowerShell，避免proc_open调用异常
