Composer 安装 ThinkPHP 6.0+ 必须满足镜像源有效（仅阿里云镜像可用）、PHP 环境完备（含 openssl/mbstring 扩展）、命令正确（仅用 create-project），且 runtime 目录权限与 public 入口路径配置无误。
composer 能装上 ThinkPHP 6.0+，前提是镜像源没失效、PHP 环境没卡住、命令用对了——三者缺一不可。国内直接走官方源大概率超时或报错，必须换镜像。
确认 composer 已就绪且能联网
执行 composer --version 必须输出版本号（如 2.5.8），否则后续全白搭。常见卡点：
- Windows 用户没把 Composer 加进系统
PATH，报错“不是内部或外部命令” - Mac/Linux 用户用
php composer-setup.php安装后，忘了加执行权限：chmod +x composer.phar，再软链到/usr/local/bin/composer - PHP 缺
openssl或mbstring扩展，composer diagnose会明确提示ext-opensslmissing
必须用阿里云镜像，别试已停用的旧地址
packagist.phpcomposer.com 镜像早在 2024 年底就停止服务，现在用它必失败。唯一稳定可用的是阿里云源：
运行这行命令（全局生效，一劳永逸）：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：composer config -g repo.packagist 应返回上面那串 URL。如果返回空或旧地址，说明没写进去，重跑一次。
立即学习“PHP免费学习笔记（深入）”；
create-project 是唯一正确安装方式
ThinkPHP 6 不支持 composer require topthink/think 这种方式引入——它不会生成 public/、runtime/ 等骨架目录，项目直接起不来。
正确命令是：composer create-project topthink/think tp6-demo
关键细节：
- 目标目录
tp6-demo必须为空，否则报错Project directory ./ is not empty - 要指定版本？加
@v6.3.0后缀：composer create-project topthink/think tp6-demo @v6.3.0 - 如果提示
Could not find package topthink/think，先清缓存：composer clear-cache，再重试
安装完立刻检查 runtime 目录权限和入口文件
安装成功只是第一步。TP6 启动时会往 runtime/ 写日志和缓存，Linux/macOS 下常因权限不足报 failed to open stream: Permission denied。
快速修复（Linux/macOS）：chmod -R 755 tp6-demo/runtime
Windows 一般不用改，但要注意：如果你用小皮、宝塔、phpStudy 等集成环境，public/index.php 是唯一合法入口，别直接访问根目录下的 index.php ——它不存在。
启动验证：cd tp6-demo && php think run，浏览器打开 http://localhost:8000，看到 ThinkPHP 默认欢迎页才算真正跑通。
最容易被忽略的是：哪怕镜像换了、命令对了、目录空了，runtime/ 权限不对或 public/ 路径没配对虚拟主机，照样 500 或 404——这里没捷径，得一项项盯。
