ThinkPHP 5.1+ 不再自动加载 _common.php，因其 think\Loader::registerCommon() 已被移除；函数应放 app/common.php 并启用 'common' => true，或在 bootstrap.php 中显式引入，避免与 Composer autoload.files 冲突。
ThinkPHP 5.1+ 中 _common.php 不自动加载的真相
不是你写错了，是 ThinkPHP 5.1 起压根就取消了对 _common.php 的默认加载机制。官方文档里没明说，但源码里 think\Loader::registerCommon() 这个逻辑在 5.1+ 版本已被移除。
常见错误现象：Call to undefined function xxx()，函数明明写在 application/common.php（或旧路径 application/_common.php）里，却始终报未定义。
- ThinkPHP 5.0 支持自动加载
_common.php，路径必须是application/_common.php - ThinkPHP 5.1+ 默认只加载
app/common.php（注意是app/，不是application/），且需手动开启配置 - 如果你用的是
application/_common.php，它不会被任何版本自动加载——除非你自己注册
手动加载自定义函数文件的三种可靠方式
最稳的做法不是“修复”自动加载，而是明确控制加载时机和位置。推荐按优先级选：
- 把函数写进
app/common.php，并在app/provider.php中确保已启用：'common' => true - 在
app/bootstrap.php开头用include_once显式引入：include_once APP_PATH . 'common.php'; - 在
app/common.php里再require其他函数文件，比如：require_once APP_PATH . 'extra/functions.php';
注意：不要在控制器或模型里用 require 加载函数文件——可能重复包含，也可能因自动加载顺序导致调用时还未加载。
立即学习“PHP免费学习笔记（深入）”；
think\facade\App::getAppPath() 和 APP_PATH 的区别与误用
很多教程教你在函数文件里用 think\facade\App::getAppPath() 拼路径，但这是错的——该方法返回的是应用根目录（如 /var/www/app/），而 APP_PATH 是框架常量，指向 app/ 目录（如 /var/www/app/app/）。混用会导致 file not found。
- 在
app/common.php或启动文件中，直接用APP_PATH更安全 -
think\facade\App::getAppPath()适合在非启动上下文（比如中间件、命令行指令）中动态获取路径 - 别在函数定义前用
include基于App::getAppPath()拼路径——此时容器可能未初始化，会报Container is empty
函数命名冲突与 Composer 自动加载干扰
如果你用 composer dump-autoload -o 生成优化类映射，而函数文件又放在 autoload.files 里，就可能出现「函数已定义」的致命错误——因为 Composer 会在所有请求开始前一次性加载，而框架又在后续流程里再次尝试加载同名文件。
- 检查
composer.json的autoload.files是否误加了app/common.php - 函数文件**不要**放进 Composer 的自动加载列表；它应该由框架生命周期控制加载时机
- 函数名避免和扩展库（如
topthink/think-helper）里的辅助函数重名，比如dump()、is_mobile()
真正容易被忽略的点是：ThinkPHP 的函数加载和 Composer 的 files 加载是两套机制，强行合并只会让加载顺序不可控，出问题也难定位。
