更新 ThinkPHP 必须在应用根目录执行 composer update topthink/framework，仅更新框架核心；全量 update 会破坏依赖兼容性，如 psr/log v3、flysystem v3 等不兼容；需确认 composer.json 中版本约束（如 "^6.2"），并检查 runtime 权限与缓存。
更新 ThinkPHP 必须在应用根目录下执行 composer update topthink/framework，不能只跑 composer update 全量更新，否则可能破坏依赖兼容性或引入不兼容变更。
更新命令必须指定 topthink/framework 包
ThinkPHP 6.x 的核心逻辑全部封装在 topthink/framework 包中，其他包（如 think-orm、think-view）是可选扩展。直接运行 composer update 会升级所有依赖，可能导致：
-
psr/log升到 v3.x 后与 TP6.0 内部日志调用不兼容 -
league/flysystem升级到 v3 后，旧版think-filesystem扩展直接报错 -
symfony/polyfill-*版本跳跃引发 PHP 版本检测异常
正确做法是明确限定范围：
composer update topthink/framework
它只会更新框架本身及其严格声明的子依赖，保留你手动安装的扩展版本不变。
立即学习“PHP免费学习笔记（深入）”；
更新前必须确认当前目录是应用根目录
所谓“应用根目录”，是指包含 app/、config/、public/、composer.json 和 think 文件的那层目录。常见错误包括：
- 在
public/目录下执行，报错Could not find a composer.json file - 在
vendor/目录下执行，报错Package operations: 0 installs, 0 updates, 0 removals - 误入上层父项目目录，导致更新了错误的
composer.json
快速验证方式：
ls -la | grep "composer.json\|think$"
看到 composer.json 和可执行文件 think 同时存在，才是对的位置。
composer.json 中的版本约束影响更新结果
composer update topthink/framework 能升到哪一版，完全取决于 composer.json 里写的版本号。例如：
-
"topthink/framework": "^6.0"→ 最多升到6.0.99，不会进 6.1 -
"topthink/framework": "6.1.*"→ 只能升到 6.1 分支的最新小版本，跳不过大版本 -
"topthink/framework": "dev-master"→ 拉取开发分支，不稳定，不建议生产环境使用
如果你希望升级到 6.2，必须先手动改 composer.json：
"topthink/framework": "^6.2"
再执行 composer update topthink/framework。不改这行，命令再跑十遍也升不上去。
更新后务必检查 runtime/ 权限和缓存
TP6 更新后常出现白屏或 500 错误，80% 是因为：
-
runtime/目录权限丢失（尤其 Linux/macOS），需重设：chmod -R 777 runtime/ - 旧版编译缓存未清除，导致新类找不到，执行：
php think clear -
.env里的APP_DEBUG=true被意外关闭，掩盖了真实错误，建议临时打开看报错
特别注意：TP6.2+ 开始，php think clear 不再自动清空 runtime/cache/ 下的模板缓存，如果视图渲染异常，要手动删掉 runtime/view/ 整个目录。
