适合新手上手，但需接受“先理解约定，再写逻辑”的节奏；Yii依赖目录结构、命名规范与组件生命周期协同工作，初学者易因MVC概念缺失、大小写错误、命名空间遗漏、OPCache未关闭等问题报错或功能异常。
Yii 新手直接上手会不会被绕晕？
适合，但有前提：你得接受“先理解约定，再写逻辑”这个节奏。Yii 不是填空式框架（比如一个函数调用就渲染出表单），它靠目录结构、命名规范和组件生命周期协同工作。没接触过 MVC 的人容易卡在 Controller 为什么不能直接 echo、view 文件为啥要放在 views/site/ 这种路径里——这不是 bug，是设计约束。
常见错误现象：Invalid Parameter – yii\base\InvalidParamException 报错却找不到哪行代码错了；访问 /index.php?r=site/about 返回 404，但文件明明存在。本质是路由没匹配到对应 actionAbout() 方法，或控制器类名/文件名大小写不一致（Windows 下可能不报错，Linux 上直接 500）。
- 实操建议：初始化项目务必用
composer create-project --prefer-dist yiisoft/yii2-app-basic basic，别手动建目录——config/web.php、controllers/SiteController.php等关键位置一旦错位，后续所有路由和组件加载都会失序 - 新手最容易忽略的是命名空间声明，比如
controllers/SiteController.php开头必须是namespace app\controllers;，少这句，use app\controllers\SiteController;就永远找不到类 - Yii2 默认关闭调试模式（
YII_DEBUG = false），初学阶段请立刻在入口文件web/index.php顶部设为true，否则错误堆栈全被吞掉，只剩白屏
gii 生成代码后为啥跑不起来？
因为 gii 只管“照模板写”，不管“上下文对不对”。它生成的 Model 类会自动加 use yii\db\ActiveRecord;，但如果你数据库还没连上、表不存在、或字段类型 Yii 不认识（比如 PostgreSQL 的 jsonb），运行时就会崩在 find() 或 save() 那一刻。
使用场景：你刚建好一张 user 表，字段是 id, name, created_at，用 gii 生成 User 模型后，访问 /index.php?r=user/index 却提示 Class 'app\models\User' not found。
- 检查
models/User.php里的命名空间是否为app\models，且文件保存路径是models/User.php（不是Models/User.php或models/user.php） - 确认数据库配置在
config/db.php中正确，执行php yii migrate前先手动连一下数据库，避免 gii 读不到表结构而生成空模型 - gii 生成的
search()方法默认用UserSearch类，但该类依赖User模型的attributes()，如果模型里重写了attributeLabels()却漏了某个字段，搜索页可能报Unknown Property
组件（Component）的属性为啥不能直接 public $xxx？
因为 Yii 的组件系统靠魔术方法 __get()/__set() 拦截属性访问，触发事件、验证、日志等扩展能力。你写 public $textWidth;，框架就当它是普通变量，不会走 getTextWidth() 和 setTextWidth()，行为、事件、验证规则全失效。
性能影响：直接 public 属性看似快，但失去统一入口后，你想在赋值前做类型转换（比如把字符串 "12px" 转成整数）、或赋值后触发 onWidthChange 事件，就得到处手动调用，维护成本指数级上升。
- 正确写法：定义私有属性
private $_textWidth;，再提供getTextWidth()和setTextWidth($value)方法 - 别忽略大小写问题：组件属性名不区分大小写（
$comp->textwidth和$comp->textWidth都能访问），但方法名本身是 PHP 的，gettextwidth()不会被识别——所以方法名必须严格驼峰 - 如果只是想快速存取，又不想写 get/set，可用
yii\base\Object（Yii2.0.14+ 推荐），它内置了属性支持，但依然要求你声明public $textWidth;并继承它，不能裸写 class
为什么改了代码页面没变化，清缓存也不管用？
Yii2 默认启用 OPCache（PHP 字节码缓存），它缓存的是编译后的 opcode，不是你改的源码。哪怕你删了整个 views/site/index.php，只要 OPCache 没过期，服务器仍返回旧版本的渲染结果。
容易踩的坑：开发时只记得删 runtimes/cache/，却忘了关 OPCache 或重启 Web 服务。尤其在 Docker 或 Nginx + PHP-FPM 环境下，PHP-FPM 进程常驻内存，改完代码必须 kill -USR2 或 service php-fpm reload 才生效。
- 本地开发建议在
php.ini中设opcache.enable=0，并确保opcache.revalidate_freq=0（否则即使开启也会每 2 秒才检查一次文件变更） - Yii 自身缓存（如
DbCache、FileCache）默认存在runtimes/cache/，但部分配置（如enableSchemaCache）会把数据库结构也缓存，改了表字段后必须手动执行php yii cache/flush-schema - 浏览器缓存和代理缓存有时会混淆判断，调试时用无痕窗口 + 看 Network 面板的
200 OK响应头，确认响应时间戳是否更新
复杂点在于：这些缓存层级（OPCache → Yii 缓存 → 浏览器缓存）是叠在一起的，少关一层，你就以为代码没生效，其实只是某层还在吐旧数据。
