composer config -g repo.packagist 命令失效是因为写法错误，正确命令是 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，缺前缀、类型值或末尾斜杠均会静默失败。
composer config -g repo.packagist 命令为什么总失效
命令执行后 composer config -g repo.packagist 仍输出空或原官网地址，说明配置根本没写进去——不是网络问题，是命令本身写错了。常见错误有三个：repo.packagist 少了 repo. 前缀、中间的 composer 类型值被删掉、URL 末尾缺斜杠 /。这三处任一出错，Composer 都会静默忽略，不报错也不提示。
正确写法只有一条：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。注意：https:// 不可换成 http://（阿里云镜像已停用 HTTP）；清华源 https://mirrors.tuna.tsinghua.edu.cn/composer/ 偶尔同步延迟，若装 dev-main 分支失败，可临时切回官方源验证。
ThinkPHP 6 和 8 的 create-project 命令怎么选版本
不加版本约束，composer create-project topthink/think tp-demo 现在默认拉的是 TP8（v8.x），不是 TP6。如果你 PHP 是 7.4，硬装 TP8 会直接报 ParseError: syntax error, unexpected token "string"。
明确指定版本才能避开踩坑：
- 装最新稳定 TP6：
composer create-project "topthink/think:^6.3" tp6-demo（推荐加双引号防 shell 解析） - 锁死小版本（生产环境）：
composer create-project topthink/think tp6-demo "6.3.10" - 装 TP8：
composer create-project topthink/think tp8-demo "8.0.5"（TP8 要求 PHP ≥ 8.1）
别用 --prefer-dist：TP6 的 build.php 和控制器 stub 文件在 dist 包里被删了，后续 php think build 会失败。
升级框架时为什么不能直接 composer update
composer update 会升级所有依赖，而 TP6 内部调用的是 psr/log:^1.0 和 league/flysystem:^1.0，一旦被升到 v3，立刻白屏或报 Call to undefined method。
只升级核心框架，必须限定范围：
- TP6 升级：
composer update topthink/framework --with-all-dependencies - TP8 升级：
composer update topthink/framework（TP8 默认兼容 v2+ 的 PSR 规范） - 升级前确认当前目录含
composer.json和可执行文件think，否则命令无效
升级完必须删掉整个 runtime/ 目录——缓存残留会导致路由、配置、模板仍走旧逻辑，页面空白却无报错。
装完 TP6/TP8 后 runtime/ 权限和 .env 文件最容易漏
很多人看到 composer create-project 执行完就以为搞定了，结果访问 500 或空白页，90% 是这两处没处理：
-
.env文件：必须从.env.example复制并重命名，至少设APP_DEBUG=true和APP_ENV=local；Windows 下务必保存为 UTF-8 无 BOM，否则php think静默退出 -
runtime/目录权限：Linux/macOS 运行chmod -R 755 runtime/；若用 WSL 或 Docker 挂载卷，需chmod -R 777 runtime/，否则日志、缓存、模板编译全失败 - 验证
think命令：进入项目目录后运行php think version，若报Permission denied，Linux/macOS 执行chmod +x think
TP8 新增了 php think run 命令，TP6 只能用 php think serve，别混用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
