控制器需用Article::where('status',1)->paginate(10)或Db::name('article')->where('status',1)->select()查数据，再return view('index',['list'=>$data])传参，模板用{volist name="list" id="vo"}遍历并{$vo.title|htmlspecialchars}防XSS。
控制器里怎么查文章数据并传给模板
ThinkPHP6.1 默认用 index 方法响应首页请求，你要在对应控制器（比如 app\controller\Index.php）里查文章列表，不能只写个空数组或直接 echo ——模板拿不到数据就渲染不出内容。
常见错误是漏掉 return view() 或传参写成 view('index', $data) 却没定义 $data；更隐蔽的是用了软删除但没调 withTrashed()，导致已删除文章“消失”却查不出原因。
- 用
Db::name('article')->where('status', 1)->order('create_time desc')->limit(10)->select()查出数组，注意字段名要和模板里一致（比如别把title写成name） - 推荐用模型查询：
app\model\Article::where('status', 1)->limit(10)->select()，好处是自动处理时间戳、自动转 JSON，且方便后续加关联（如作者信息） - 传参必须用
return view('index', ['list' => $articles])，键名list要和模板里{$list}对应，大小写敏感
模板里怎么安全遍历并输出文章标题和链接
ThinkPHP6 的模板引擎默认关闭 PHP 原生语法，得用 {volist} 标签，不是 foreach；而且 URL 生成必须用 url() 助手函数，硬写 /article/1 会因路由配置变化直接 404。
容易踩的坑：标题含 HTML 标签时没过滤，导致 XSS；或者 create_time 直接输出时间戳，页面显示一串数字。
立即学习“PHP免费学习笔记（深入）”；
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
- 用
{volist name="list" id="vo"}...{/volist}遍历，name必须和控制器传入的键名一致（比如传了['articles' => $data]，这里就得写name="articles"） - 标题输出用
{$vo.title|htmlspecialchars}防 XSS；时间格式化用{$vo.create_time|date='Y-m-d',###} - 详情链接写成
{:url('article/read', ['id' => $vo.id])}，别拼字符串；如果路由是资源路由，也可以用{:url('Article/read', ['id' => $vo.id])}
为什么首页刷新后文章列表不更新
不是代码问题，大概率是开启了模板缓存或数据缓存。ThinkPHP6.1 默认开启模板编译缓存，改了模板不生效；如果用了 Cache::get() 或模型的 cache() 方法查数据，缓存没过期也会一直返回旧结果。
- 开发阶段建议关掉模板缓存：在
config/template.php里设'cache' => false - 查数据库前加日志：
trace('SQL: ' . Db::getLastSql());，确认是不是真在查库，还是从缓存读的 - 如果用了
Article::cache(true)->select()，清缓存要执行Cache::clear('think');或删runtime/cache/下对应文件
分页功能加不上？paginate() 总报错
paginate() 不是普通方法，它返回的是 Paginator 对象，不能直接当数组遍历；模板里也不能用 {volist} 套它，得用 {pages} 标签或手动取 $page->items()。
典型报错是 Call to a member function make() on null，通常是数据库连接失败或没加载分页驱动；还有人把 paginate(10) 写在 select() 后面，顺序错了。
- 正确写法：
Article::where('status', 1)->order('id desc')->paginate(10)，注意是链式调用，不是->select()->paginate(10) - 模板里遍历用
{volist name="list" id="vo"}...{/volist}（$list是分页对象的items()结果），分页条单独写{$list->render()} - 如果路由带参数（比如分类 ID），分页链接会丢参，得加
->appends(request()->param())
真正卡住的往往不是语法，而是控制器没 return、模板变量名对不上、或者缓存没清干净——尤其上线后改了字段却忘了清 runtime/ 目录，页面看着“不动”，其实连 SQL 都没发出去。
