autoload.files 配置需在 composer.json 中正确定义 files 数组路径并执行 composer dump-autoload -o 生效；入口文件必须首行加载 vendor/autoload.php；函数文件不能含 namespace 声明；CLI 下 request() 需手动初始化请求实例。
查 autoload.files 配置是否生效
ThinkPHP 6+ 的全局函数（如 request()、url()、config()）不是靠 PSR-4 自动加载的，而是通过 Composer 的 autoload.files 配置项，在框架启动时一次性引入。如果这些函数报 Call to undefined function，第一件事就是确认该配置是否被正确加载。
打开项目根目录的 composer.json，检查是否存在类似这样的配置：
"autoload": {
"psr-4": { "app\": "app/" },
"files": [
"app/common/function.php",
"app/common/helper.php"
]
}
注意：files 数组里的路径是相对于 composer.json 的，且必须是真实存在的 PHP 文件；每行末尾不能有逗号（JSON 语法严格）；路径中不要用 __DIR__ 或变量——那是运行时逻辑，Composer 不识别。
改完后必须执行：
立即学习“PHP免费学习笔记（深入）”；
composer dump-autoload -o
否则修改不生效。这个命令会把 files 列表编译进 vendor/composer/autoload_files.php，后续所有请求都依赖它加载。
确认入口文件是否加载了 vendor/autoload.php
ThinkPHP 6+ 的自动加载完全依赖 Composer，而入口文件（如 public/index.php）第一行就必须加载它。漏掉或顺序错位，会导致整个 autoload 机制失效。
检查 public/index.php 开头是否为：
require __DIR__ . '/../vendor/autoload.php';
常见错误包括：
- 这行被注释或删掉了
- 写成了
require 'vendor/autoload.php'（相对路径在 CLI 下会失败） - 这行被挪到了中间，前面已有类/函数调用
- 用了
include而非require，出错时不中断，但后续函数不可用
只要这一行没跑通，autoload.files 就不会触发，所有助手函数都不可见。
函数文件里不能有命名空间声明
autoload.files 加载的是“全局作用域”的函数文件。如果在 app/common/function.php 里写了 namespace appcommon;，那里面定义的函数就不再属于全局空间，调用时会直接报未定义。
这类文件必须满足：
- 顶部不能有任何
namespace声明 - 不能有
class或trait定义（除非你明确只当工具类用，且不依赖 autoload.files） - 函数定义要直出，比如
function my_helper() { ... }，不能套在条件块或闭包里
一个典型错误写法：
namespace appcommon;
function url_safe($str) { return str_replace(['/', '\'], '-', $str); }
这样写，url_safe() 实际是 appcommonurl_safe()，调用时得加反斜杠：url_safe() 才行——但没人这么用助手函数。
CLI 环境下 request() 报错要手动补初始化
在命令行（如 php think hello）中调用 request() 报错，大概率不是 autoload 问题，而是框架 HTTP 生命周期没走完。CLI 模式下 request() 助手函数虽然已加载，但内部依赖的 thinkRequest 实例尚未创建。
解决方式不是改 autoload，而是显式初始化：
- 在命令行脚本开头加
thinkApp::init();（TP6.1+） - 或者更稳妥地，直接 new 实例：
$request = hinkRequest::instance(); - 避免在
Command类的__construct()中就调用request()，此时容器和请求对象都还没准备好
这点容易被忽略：autoload 只管“函数存在”，不管“函数能正常执行”。request() 是个带运行时依赖的代理函数，它本身存在，但背后实例没建好，照样崩。
最常被跳过的环节是：改了 composer.json 却忘了 dump-autoload -o；或者以为加了 files 就万事大吉，结果函数文件里偷偷加了 namespace。这两处一错，函数就永远“看不见”。
