CodeIgniter 4 中 return view() 传数组时键名必须与视图变量名完全一致，且第二参数必须为数组，否则报错；视图不自动解包对象，需显式传递关联数组并核对键名。
控制器里用 return view() 传数组，键名必须和视图中变量名完全一致
CodeIgniter 4 的视图不支持自动解包对象或魔术变量，只认你明确传进去的数组键。比如控制器写了 $data['users'] = $model->findAll();，那视图里就得直接写 $users —— 写成 $user_list 或 $data['users'] 都会报 Undefined variable 错误。
常见错误现象：
- 页面空白，日志里出现
PHP Notice: Undefined variable: xxx - 数据明明查出来了，
var_dump($xxx)却显示null
实操建议：
- 始终用关联数组，避免用数字索引或对象直接传入
- 在控制器里加一句
helper('debug'); dd($data);确认传出去的结构和键名 - 视图中用
isset($xxx)或!empty($xxx)做兜底，别直接 echo 未定义变量
view() 第二个参数只接受数组，不能传对象或原始值
CI4 的 view() 函数签名是 view(string $name, array $data = [], array $options = [])。传入非数组（比如 Model 实例、字符串、null）会导致静默失败或报错 Invalid argument supplied for foreach()（尤其在视图里用了 foreach($items as $item) 时）。
使用场景举例：
- 正确：
return view('profile', ['user' => $userModel, 'posts' => $posts]); - 错误：
return view('profile', $userModel);（会触发类型警告） - 错误：
return view('profile', 'hello');（直接报Argument 2 passed to CodeIgniter\View\View::render() must be of the type array）
性能影响：传对象虽不报错（如果启用了自动转换），但 CI4 默认不会帮你把对象转成可遍历数组，容易在视图里踩空指针。
需要返回渲染后 HTML 字符串？设第三个参数为 true
和 CI3 不同，CI4 的 view() 默认直接输出内容。如果你要捕获 HTML 做后续处理（比如拼邮件模板、存缓存、做 SSR 包裹），得显式传 true 作为第三个参数。
示例：
$html = view('email/welcome', ['name' => '张三'], ['debug' => false]);
// $html 是字符串，不会输出到浏览器
send_email('welcome@site.com', $html);
注意点：
- 第三个参数是
array $options，不是布尔值；真正控制是否返回字符串的是options['saveData']，但官方文档已标明：设为true即启用返回模式（向后兼容写法） - 别漏掉第二个参数占位，哪怕传空数组：
view('partial', [], true)，否则会报参数数量错误 - 开启
debug模式时，返回的字符串里可能含调试注释，生产环境记得关掉
动态数据来自数据库但视图没显示？先核对变量名和作用域
最常被忽略的不是查询逻辑，而是变量名映射断层。比如控制器里 $data['orders'] = $orderModel->where('status', 'paid')->findAll();，视图却写了 foreach($order_list as $o) —— 这种错法 CI4 不报错，只是循环不执行。
排查步骤：
- 打开 CI4 的 debug toolbar，看「Views」面板里实际传了哪些变量（键名）
- 在视图开头加
<?php dd(get_defined_vars()); ?>，确认变量是否存在、类型是否为数组 - 检查是否在视图里用了
extract($data)—— CI4 视图引擎默认不用这个，手动加反而破坏作用域 - 如果用了视图布局（layout），确保
$this->renderSection('content')正确包裹了数据消费代码
个性化强或需局部刷新的内容，不要硬塞进静态视图；该用 AJAX 补的就补，别为了“一次传全”让整个页面失去缓存能力。
