ThinkPHP项目搭建慢主因是APP_DEBUG未真正关闭、路由/配置缓存未生成启用、Composer自动加载未优化、OPcache配置不当及Xdebug未禁用；需验证config('app.debug')为false、执行php think clear和route:cache/config优化、生成classmap、设opcache.validate_timestamps=0并注释xdebug.so。
ThinkPHP项目搭建慢，通常不是框架本身的问题，而是环境配置、调试残留、缓存机制没对齐这几个环节出了偏差。真正卡住的往往不是写代码那会儿，而是第一次运行、部署或切换环境时——比如 composer install 卡住、vendor 加载慢、路由扫描耗时、模板反复编译，甚至 PHP 进程在等一个根本没开的 Xdebug 连接。
确认 APP_DEBUG 是否真正关闭
改了 .env 里的 APP_DEBUG=false，不等于它真的关了。框架优先读 config/app.php 中的 'debug' => true，甚至某处 define('APP_DEBUG', true) 也能直接覆盖所有配置。
- 用命令行验证真实值：php -r "var_dump(config('app.debug'));"，输出必须是 bool(false)
- 检查 config/app.php，删掉或设为 'debug' => false
- 全局搜索 define('APP_DEBUG'，尤其入口文件和公共初始化脚本里
- 运行 php think clear 清空 runtime 缓存，否则旧的调试态模板、路由仍会被加载
生成并启用路由与配置缓存
没启用路由缓存时，每次请求都要重新解析 route/app.php + 扫描注解，IO 和反射开销极大。TP 默认不自动生成，必须手动触发且显式启用。
- 执行 php think route:cache，生成 runtime/route/route.php
- 执行 php think optimize:config，生成 runtime/init.php，跳过 config/ 下全部 PHP 文件
- 确保 config/app.php 中开启：'route_check_cache' => true
- 检查 runtime/route/ 目录权限，Web 进程用户（如 www-data）需有读取权限
- 多应用模式下，确认生成路径匹配当前应用名，例如 runtime/route/admin/route.php
优化 Composer 自动加载与 runtime IO
vendor 加载慢，常见原因是自动加载退化成实时遍历；runtime 目录写入卡顿，往往不是磁盘问题，而是 is_dir()、mkdir() 在 Docker/NFS 环境下被放大延迟。
立即学习“PHP免费学习笔记（深入）”；
- 运行 composer dump-autoload -o 强制生成 classmap，避免 PSR-4 实时扫描
- 禁用 ThinkPHP 的 extend/ 自动加载：'extend_list' => [] 写进 config/app.php
- 显式指定 runtime_path：'runtime_path' => '/tmp/thinkphp-runtime/'（推荐 tmpfs 路径）
- 确保目录属主与 PHP 进程一致（如 chown www-data:www-data /tmp/thinkphp-runtime）
- 关闭模板 Lite 校验：'cache_lite' => false（config/template.php 中）
检查 OPcache 与 Xdebug 配置
OPcache 配置错位会导致命中率低于 30%；Xdebug 没关，PHP 会卡在连接 IDE 的等待上，哪怕你根本没开 PhpStorm。
- OPcache 必须同时设：opcache.validate_timestamps=0 和 opcache.revalidate_freq=0
- opcache.max_accelerated_files 至少设为 20000（TP8 建议 65536）
- opcache.memory_consumption 起步 128MB，中等项目建议 256MB
- 生产环境直接注释掉 php.ini 中的 zend_extension=xdebug.so 行
- 若需性能分析，改用 xdebug.mode=profile + xdebug.start_with_request=trigger，通过请求头触发
