命名空间找不到的根本原因是自动加载机制未识别类文件，需确保路径与命名空间严格对应、文件名与类名一致、Composer PSR-4 配置正确并执行 dump-autoload，无命名空间的老库须手动引入且实例化加反斜杠。
找不到命名空间，本质是自动加载机制没把类文件“认出来”。核心就两点：路径必须和命名空间严格对应，文件本身得符合框架识别规则。不是改个 use 就能解决的。
检查命名空间与文件路径是否完全匹配
ThinkPHP 6+ 严格遵循 PSR-4 规范，不能有丝毫偏差：
- 如果类文件在 app/service/ExcelHelper.php，命名空间必须写成 namespace appservice;（注意反斜杠，全部小写，无空格）
- 类名必须与文件名一致：ExcelHelper.php → class ExcelHelper，不能是
class excelhelper或class ExcelHelperClass - Linux 服务器区分大小写，
AppService和appservice是两个不同命名空间，本地 Windows 能跑不代表线上没问题
没有命名空间的类库必须手动导入
像 PHPExcel、QRCode 这类老库，本身没 namespace，框架无法自动加载，必须显式引入：
- 把文件放到 extend/ 目录下（如
extend/PHPExcel/PHPExcel.php） - 用
import('PHPExcel.PHPExcel', EXTEND_PATH)或Loader::import('PHPExcel.PHPExcel', EXTEND_PATH) - 实例化时加反斜杠：
$excel = new PHPExcel();（不加 会去当前命名空间里找，必然报错）
确认 Composer 自动加载已生效
哪怕写了 namespace，如果 Composer 没注册这个路径，照样找不到：
立即学习“PHP免费学习笔记（深入）”；
- 打开 composer.json，检查
"autoload": {"psr-4": {...}}是否包含你的命名空间映射，例如："app\": "app/" - 修改后必须运行
composer dump-autoload（不要加-o，避免缓存干扰） - 临时加一行
var_dump(class_exists('appserviceExcelHelper'));到入口或控制器里，看返回是不是 true
vendor 类库别乱用 use，优先走 vendor() 辅助函数
从 Packagist 安装的库，比如 phpoffice/phpexcel，不建议直接 use：
- 用
vendor('PHPExcel.Classes.PHPExcel')快速加载（TP5/6 兼容） - 或用
Loader::import('PHPExcel.Classes.PHPExcel', VENDOR_PATH) - 之后仍要写
new PHPExcel()，因为 vendor 下的类通常也没有命名空间
不复杂但容易忽略。关键就是路径、命名空间、加载动作三者对齐，少一个环节都会报错。
