TP5中require和include不会自动报错，但行为差异会立刻暴露在运行时；include失败常被静默吞掉致页面空白，require则因致命错误直接终止执行。
require 和 include 在 TP5 里会直接报错吗？
不会自动报错，但行为差异会立刻暴露在运行时。ThinkPHP 5 默认关闭了 E_WARNING 显示（PHP 8+ 更是默认不输出警告），所以你很可能遇到：include 'config.php' 失败后页面空白、无提示、日志里也找不到线索——不是没报错，是被静默吞掉了。
实操建议：
- 开发阶段务必在
public/index.php开头加error_reporting(E_ALL); ini_set('display_errors', '1'); - 上线前把
include换成require的关键路径（比如think/Loader.php、app/config.php），避免配置漏载导致逻辑错乱却难以定位 - TP5 的自动加载机制已接管绝大多数类文件引入，手动
require类文件基本不需要，别在控制器里写require '../extend/MyClass.php'—— 这属于反模式
什么时候必须用 require_once 而不是 include？
当你在非自动加载路径下手动引入定义了函数、类或常量的文件时，require_once 是唯一安全选项。TP5 的 extend/ 目录或自建的 common/ 工具目录里，如果放了 function.php 或 Helper.php，重复包含会直接触发 Fatal error: Cannot redeclare xxx()。
注意两个常见坑：
立即学习“PHP免费学习笔记（深入）”；
-
require_once 'helper.php'和require_once './helper.php'被 PHP 视为两个不同路径，哪怕指向同一文件，也会重复加载报错 - TP5 的
Loader::addNamespace()或 composer autoload 配置后，应彻底弃用手动require_once引入类——否则可能和自动加载冲突，造成类找不到或加载两次
TP5 中还能用 include_path 吗？
能，但不推荐。TP5 的底层加载器（如 think\Loader）完全绕过了 PHP 原生的 include_path 查找逻辑，它靠的是命名空间映射 + 注册的 PSR-4 路径。如果你在 php.ini 里设置了 include_path = "/var/www/mylib"，然后在控制器里写 include 'Utils.php'，TP5 不会帮你找，PHP 会按原规则去 include_path 里翻，结果大概率是 failed to open stream。
更可靠的做法：
- 用绝对路径：
require __DIR__ . '/../extend/Utils.php'; - 用 TP5 提供的助手函数：
vendor\topthink\framework\src\think\facade\App::getAppPath()或直接app_path('..')（需确认版本支持） - 把工具类统一注册进 composer autoload，然后用
use导入——这才是 TP5 推荐路径
为什么 TP5 启动流程里全是 require 而不是 include？
因为框架启动链上每个环节都不可跳过：require 加载 think/Loader.php 失败，后续所有自动加载、路由解析、中间件注册全崩；require 加载 app/config.php 失败，数据库配置、缓存驱动等全为空，但脚本不会告诉你哪错了——它根本走不到报错那一步，直接 Fatal error 终止。
简单说：TP5 把「基础依赖必须存在」这件事交给了 require 的语义保证，而不是靠人肉检查 if (file_exists()) 再 include。你在写自己的核心初始化逻辑（比如读取全局配置、连接主数据库）时，也该沿用这个原则。
真正需要 include 的场景，在 TP5 里几乎只出现在模板渲染层：比如 include $this->fetch('widget/sidebar')，侧边栏模板缺失不影响主体内容输出——这时才轮到 include 发挥它的“软失败”特性。
