class not found 错误主因是自动加载未生效：确认 vendor/autoload.php 是否被入口文件正确引入；检查 composer.json autoload 配置并执行 composer dump-autoload -o；避免 extend/ 目录直接放类或重复引入 autoload；优先使用国内镜像加速安装。
composer install 报错 “Class not found” 怎么办
不是 composer install 没跑完，而是它跑完了但自动加载没生效。ThinkPHP 依赖的类（比如 thinkContainer）找不到，大概率是 vendor/autoload.php 没被正确引入，或 composer dump-autoload 没触发 PSR-4 映射更新。
实操建议：
- 确认入口文件（如
public/index.php）第一行是否包含require __DIR__ . '/../vendor/autoload.php';，漏了就补上 - 删掉
vendor/和composer.lock，重新运行composer install --no-dev（生产环境别加--dev） - 如果改过
composer.json里的autoload配置（比如新增了psr-4映射），必须手动执行composer dump-autoload -o，否则新路径不进自动加载表 - 检查
vendor/composer/autoload_psr4.php文件里有没有你期望的命名空间映射，没有说明dump-autoload没生效或配置写错了
ThinkPHP 6+ 的 extend 目录类无法自动加载
ThinkPHP 官方不推荐把自定义类扔进 extend/ 目录后指望它自动可用——这个目录默认不在 Composer 的自动加载范围内，也不是框架原生扫描路径。
实操建议：
- 不要直接在
extend/下放类然后new ExtendClass()，会报Class 'ExtendClass' not found - 要么把
extend/加进composer.json的autoload.psr-4，例如："extend\": "extend/"，再跑一次composer dump-autoload -o - 要么改用
app/下新建模块（如app/common），并在composer.json中统一映射，更符合 TP6+ 的组织习惯 - 注意大小写：Windows 下不敏感，Linux 服务器上
Extend/Helper.php和extend/helper.php是两个路径，PSR-4 匹配失败就找不到类
vendor/autoload.php 被引入两次导致 Fatal error
常见于在中间件、命令行脚本或测试文件里重复 require 自动加载文件，PHP 会报 Fatal error: Cannot redeclare class 或 Cannot redeclare function。
实操建议：
- 入口文件（
public/index.php、think命令脚本）引入一次就够了，其他地方一律禁止再require vendor/autoload.php - 如果写单元测试（比如用 PHPUnit），在
phpunit.xml里通过bootstrap指定自动加载，而不是在每个测试文件顶部require - 自定义命令类（继承
thinkConsoleCommand）里不要手动引入，框架启动时已加载完成 - 检查是否有 IDE 自动生成的测试桩、或某些第三方 SDK 示例代码偷偷
require了 autoload，这类“隐形引入”最难排查
composer install 很慢或卡在 “Loading composer repositories”
不是网络问题就是镜像源失效。Composer 默认走 packagist.org，国内访问不稳定，且 ThinkPHP 依赖的 topthink/think-orm 等包体积不小，容易超时。
实操建议：
- 临时切国内镜像：
composer config -g repo.packagist composer https://packagist.phpcomposer.com（注意该镜像已停用），现推荐用https://packagist.laravel-china.org或阿里云镜像https://mirrors.aliyun.com/composer/ - 运行前先清缓存：
composer clear-cache，避免旧缓存干扰 - 加
--prefer-dist参数强制走压缩包而非 Git 克隆，快很多：composer install --prefer-dist --no-dev - 如果项目用了私有包（如公司内网 GitLab），确认
composer.json里的repositories配置可访问，否则会卡住并静默失败
自动加载机制本身不复杂，但和 ThinkPHP 的生命周期、目录约定、Composer 配置三者咬合得紧。最容易忽略的是：你以为类“应该能加载”，其实它根本没进 autoload_classmap.php 或 autoload_psr4.php ——遇到问题，先看这两个文件里有没有你的命名空间。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
