页面渲染空白的首要原因是PHP执行中断或HTML未被正确解析。需检查Network面板的状态码与Content-Type，确认ENVIRONMENT为development以显示错误，验证控制器是否执行到view()，排查视图文件路径、变量名及HTML结构错误。
页面渲染空白，大概率不是视图没写对，而是 HTML 根本没被浏览器当成 HTML 解析，或 PHP 在输出前就中断了。
检查 Network 面板里 HTML 响应状态和 Content-Type
打开浏览器开发者工具（F12），切到 Network 面板，刷新页面，找你访问的 URL（比如 /register-bill 或 /index.php/welcome）：
- 如果状态码是
404或403，说明请求根本没落到 CodeIgniter，检查.htaccess是否生效、Apache/Nginx 是否开启重写模块、URL 路径是否带错大小写或多余斜杠 - 如果状态码是
200但响应头里Content-Type不是text/html（比如成了text/plain或空），浏览器会把 HTML 当纯文本显示——右键“查看页面源代码”能看到标签，但页面就是白的；此时需在控制器里显式设置：$this->response->setContentType('text/html'); - 如果响应体为空（Preview/Response 面板一片空白），说明 PHP 执行提前终止，没走到
view()这一步
确认 ENVIRONMENT 是 development 且错误显示已开
CodeIgniter 默认在 production 环境下屏蔽所有错误输出，白屏时什么提示都没有。打开项目根目录下的 index.php，找到类似这行：
define('ENVIRONMENT', 'production');改成：
define('ENVIRONMENT', 'development');再刷新。常见报错包括：
-
Parse error: syntax error, unexpected token→ PHP 版本太低（CI4 要求 PHP 8.0+）或模板里写了非法语法 -
Class 'RegisterModal' not found→ 模型类名/文件名不匹配，或命名空间漏写use App\Models\RegisterModal; -
Call to undefined method App\Models\RegisterModal::findAll()→ 模型没继承CodeIgniter\Model
验证控制器是否真执行到了 view() 且数据传对了
别只信逻辑，加一句临时调试输出，确认流程走到哪了：
public function index()
{
$registerModal = new RegisterModal();
$data['tb_bills'] = $registerModal->orderBy('id', 'DESC')->findAll();
// 加这句，看是否执行到这里
echo '<!-- data count: ' . count($data['tb_bills']) . ' -->';
return view('register-bill', $data);
}然后在浏览器“查看页面源代码”，搜 data count。如果没看到，说明卡在上面某步（比如模型查询抛异常但被静默吞了）；如果看到了但页面还是白，重点查视图文件本身：
- 确认
app/Views/register-bill.php存在且路径拼写完全一致（CI4 区分大小写） - 检查视图里是否用了未定义变量，比如
$tb_bills传了但模板里写成$bills，empty($tb_bills)就会判为true，整个<tbody> 块跳过<li>避免在视图里写可能出错的 PHP 逻辑，比如直接调用未初始化的对象方法</li> <h3>排除 HTML 解析中断导致的伪空白</h3> <p>即使 PHP 正常输出，HTML 结构错误也会让浏览器放弃后续渲染。典型表现是：源代码里能看到开头几行 HTML，但后面全没了。</p> <ul> <li>打开浏览器“查看页面源代码”，从底部往上删内容，每次删一段后刷新，直到页面出现——最后删掉的那块就是问题源头</li> <li>常见罪魁：<code><script></script>标签没闭合、<pre class="brush:php;toolbar:false;"></pre>或<textarea></textarea>里写了未转义的字符、模板中混用了 Blade 风格的 <code>{{ }}语法（CI4 视图是原生 PHP） - 用 W3C 验证器（validator.w3.org）粘贴源代码，重点关注
Unclosed element和Stray end tag报错
最易被忽略的一点：CI4 的视图是直接 include 执行的，任何语法错误、未捕获异常、甚至 exit 都会让后续 HTML 彻底消失——所以白屏时，永远先确认 PHP 错误有没有打出来，而不是急着改 HTML 或 JS。
