ThinkPHP 8.0开发环境代码不生效主因是分层缓存未清干净：APP_DEBUG=true仅跳过配置与路由缓存，但模板（runtime/view/）、字段结构（runtime/schema/）、OPcache仍生效；需逐层清理并验证。
开发环境下改完代码不生效，八成不是你写错了，而是缓存没关干净——ThinkPHP 8.0 的缓存是分层的，模板、配置、路由、模型查询、OPcache 全都可能锁住你的修改。关缓存不能只靠 APP_DEBUG => true，得一层一层拆。
APP_DEBUG=true 是起点，不是终点
很多人以为开了调试模式就万事大吉，其实它只跳过「框架级配置缓存」和「路由缓存」，但以下几类依然生效：
-
runtime/view/下的模板编译文件（哪怕TMPL_CACHE_ON => false，旧编译文件不删仍可能被加载） -
runtime/schema/和runtime/temp/里的字段缓存、临时类缓存 - PHP OPcache 缓存的
config/app.php或config/database.php字节码（改了文件，OPcache 还在用旧版本）
所以第一步永远是确认：var_dump(config('app.debug')) 输出 true，且 .env 里没写 APP_DEBUG=false 覆盖它。
模板不刷新？删 runtime/view/ + 关 cache 配置
模板改了没反应，常见于 runtime/view/ 下残留了旧编译文件。ThinkPHP 8.0 不会自动覆盖同名编译文件，尤其是命名空间或路径微调后。
立即学习“PHP免费学习笔记（深入）”；
- 手动清空：
rm -rf runtime/view/（Linux/macOS）或直接删掉该文件夹（Windows） - 同时确保配置中显式关闭：
'template' => ['cache' => false]，而不是只依赖APP_DEBUG - 如果用了自定义模板引擎（如 Blade），还要检查对应驱动的缓存开关，比如
blade.compiler.cache_path
注意：TMPL_CACHE_ON 在 TP8 已废弃，别再往 config 里硬塞这个键。
config() 读不到新值？先清 runtime/config.php，再刷 OPcache
改了 config/app.php 或 .env，config('app.app_name') 还是旧的，大概率是这两层卡住了：
-
runtime/config.php文件存在且非空 → 框架优先加载它，忽略源文件 - PHP OPcache 缓存了刚改过的 config 文件 → 即使删了
runtime/config.php，config/app.php本身还是旧字节码
正确操作顺序：
- 删缓存文件：
rm -f runtime/config.php - 重建配置缓存（仅当
APP_DEBUG=false时才需要，但开发中建议先设为 true 再删）：php think config:cache - 重启 PHP-FPM 或执行
opcache_reset()（CLI 下可直接调，Web 环境需配合探针或 reload）
别信“刷新浏览器”或“重启 Apache”，这些对 OPcache 无效。
路由新增不生效？别只清 route.php
加了新路由却 404，尤其用注解路由时，问题常出在三个地方：
-
APP_DEBUG=true时，php think route:cache生成的runtime/cache/route.php根本不参与匹配，删了也没用 - 注解路由必须加
--annotation参数重建：php think route:cache --annotation，漏掉就扫描不到@Route - 多应用项目下，每个应用都有独立的
runtime/cache/route.php（如app/admin/runtime/cache/route.php），得逐个清
最稳的开发姿势：入口文件 public/index.php 顶部加一行 define('THINK_ROUTE_CACHE', false);，彻底绕过路由缓存逻辑，比反复删文件更可靠。
缓存不是单个开关，是一张网。TP8 的分层设计让每层都能独立生效，也意味着关不全就等于没关。最常被忽略的是 OPcache 和 runtime/schema/ ——它们不声不响，却让你改十次代码都白改。
