必须写 yiisoft\yii2 命名空间，否则类自动加载失败、报 class not found 错误，项目无法启动；因 composer 的 psr-4 映射将 yiisoft\yii2 映射至 vendor/yiisoft/yii2/，真实类路径如 yiisoft\yii2\web\application，漏写会导致 php 在错误作用域查找。
漏写 yiisoft 命名空间，最直接的后果是类自动加载失败、报 Class not found 错误，项目根本无法启动。
为什么必须写 yiisoft\yii2
Yii2 的核心类（如 yii\web\Application、yii\db\ActiveRecord）全部定义在 yiisoft\yii2 这个根命名空间下。Composer 自动加载机制依赖 autoload 配置中的 PSR-4 映射，而官方包 yiisoft/yii2 的 autoload 规则明确将 yiisoft\yii2 映射到 vendor/yiisoft/yii2/ 目录。
如果你在代码里写成 use yii\web\Application;（少了 yiisoft\），PHP 就会在当前作用域或全局命名空间里找 yii\web\Application，自然找不到——因为真实路径是 yiisoft\yii2\web\Application。
常见漏写场景和表现
- 手动创建控制器或模型时，
use语句写成use yii\base\Controller;→ 报错：Class 'yii\base\Controller' not found - 配置文件中引用类名，比如
'class' => 'yii\console\Application'→ 启动 console 命令时报错，提示类不存在 - 扩展包文档示例未说明命名空间层级（尤其老教程），照抄导致错误
- IDE 自动补全默认推荐
yii\...，但没触发yiisoft\yii2\...，开发者没注意就确认了
正确写法与验证方法
所有 Yii2 官方类的完整命名空间都以 yiisoft\yii2 开头：
use yiisoft\yii2\web\Application;use yiisoft\yii2\db\ActiveRecord;use yiisoft\yii2\console\Controller;
验证是否生效：运行 php yii 或访问首页，不报 ClassNotFound；用 IDE 点击 use 后的类名能正常跳转到 vendor 中对应文件。
顺带提醒：别混淆 vendor 名称和命名空间
yiisoft/yii2 是 Composer 包名（vendor/name），不是 PHP 命名空间；它的命名空间是 yiisoft\yii2（反斜杠分隔，无斜杠）。同理，yiisoft/yii2-bootstrap5 的命名空间是 yiisoft\yii2\bootstrap5，不是 yii\bootstrap5。
