必须先设置阿里云镜像源，因为 packagist.org 官方源在国外，国内直连易超时或失败；正确命令是 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。
为什么安装 TP6 时要先设镜像
因为 packagist.org 官方源在国外，国内直连常超时、卡在 downloading 或直接报 Could not find package topthink/think。不设镜像就装，大概率等 10 分钟后失败。阿里云镜像（https://mirrors.aliyun.com/composer/）目前稳定且同步及时，是首选。
设置全局镜像的正确命令是什么
执行这一条就够了：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意点：
-
config -g表示全局配置，不用每次进项目都设 - 别用已停用的老镜像，比如
https://packagist.phpcomposer.com或https://packagist.laravel-china.org（后者早已下线） - 如果提示
Permission denied，说明你没用管理员权限运行终端（Windows）或没加sudo（Linux/macOS），但更可能是 Composer 本身没装好——先跑composer --version确认可用 - 设完可验证：
composer config -g -l | grep "repo.packagist"，输出里url字段必须是阿里云地址
设了镜像还是装不上 TP6 怎么办
常见真因不是镜像问题，而是缓存或命令误用：
立即学习“PHP免费学习笔记（深入）”；
- 执行过旧命令（如
composer require topthink/think）会失败——TP6 不支持这种方式，必须用create-project - 本地有残留缓存：运行
composer clear-cache再重试 - 想装指定版本但写法错，正确写法是：
composer create-project topthink/think tp6-demo @v6.3.0，不是=v6.3.0或:v6.3.0 - 当前目录已有同名文件夹（如
tp6-demo），create-project会直接报错退出，删掉再试
安装完成后 runtime 目录写不了日志怎么办
这不是镜像问题，但常被误认为“装坏了”。TP6 启动后默认往 runtime/ 写缓存和日志，Linux/macOS 下若权限不足，会报 failed to open stream: Permission denied。
解决方法只有一条：
chmod -R 755 runtime
注意：
- 别用
777，开发环境够用就行，线上应更严格 - Windows 用户一般无此问题，但若用 WSL，同样要检查
runtime所在文件系统是否挂载为可执行 - 这个权限问题不会影响
composer create-project成功与否，它只在首次访问public/index.php或运行php think run时暴露
composer clear-cache 和 composer --version 过一遍，比反复重试快得多。 
