必须通过vendor()助手函数或loader::import()引入vendor文件，因手动require会绕过composer自动加载机制，导致class not found、依赖未初始化及框架生命周期破坏。
vendor 文件不能靠 require 直接引入，否则会报错
直接写 require '../vendor/xxx/yyy.php' 或 include_once 看似能跑通，但极大概率在中间件、命令行、钩子或并发请求中触发 Class not found 或 Function undefined。原因在于 TP5 的自动加载机制依赖 Composer 的 autoload.php 注册规则，手动引入绕过了命名空间解析和类映射，导致后续依赖（如数据库连接、配置读取）未初始化就执行，破坏框架生命周期。
必须通过 vendor() 助手函数或 Loader::import()
TP5 提供了专用于 vendor 目录的导入方式，它会补全路径、处理后缀、并兼容当前环境（Web / CLI）。两种等效写法：
-
vendor('tes.Ind')—— 推荐，简洁，自动拼接VENDOR_PATH和.php后缀 -
think\Loader::import('tes.Ind', VENDOR_PATH)—— 显式控制路径，适合需要指定后缀（如.inc）的场景
注意：tes.Ind 表示文件路径为 vendor/tes/Ind.php；若实际是 vendor/tes/src/Ind.php，则应写成 vendor('tes.src.Ind')，因为点号 . 会被自动转为目录分隔符。
手动拷进 vendor 的文件不会被自动加载
Composer 安装的包（如 composer require phpoffice/phpspreadsheet）会写入 vendor/composer/autoload_psr4.php，TP5 启动时自动注册。但你手工复制进去的 PHP 文件，哪怕放对位置，也不会进 autoload 映射表。此时只有两种选择：
- 用
vendor()或Loader::import()显式加载（仅限当前请求） - 在
composer.json中加"autoload": {"files": ["vendor/yourlib/init.php"]}，再运行composer dump-autoload（推荐长期使用）
后者能让该文件随框架启动自动载入，且支持跨请求复用，但要求文件内不依赖未初始化的 TP5 组件（如 Db、Cache），否则仍会报错。
常见错误：路径写错、命名空间冲突、重复加载
典型现象包括：Warning: Cannot declare class xxx, because the name is already in use 或 Call to a member function fetch() on null。排查要点：
- 确认
vendor()参数里没有多余斜杠或扩展名（如vendor('xxx/Ind.php')错误，应为vendor('xxx.Ind')） - 检查目标文件是否已声明命名空间；若无命名空间，类名不能与 TP5 内置类重名（如
Request、Response） - 避免在多个控制器方法里反复调用
vendor()，同一文件多次加载会触发重复定义警告
真正稳定的做法，是把第三方逻辑封装成服务类，通过 bind 绑定到容器，而非每次手动引入——但这已超出“手动引入”范畴，属于架构优化层面的事了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
