dede list 调用不出来

核心排查思路

请按照以下顺序进行检查,因为后面的步骤依赖于前面的步骤是否正确。

第一步：检查最基本的调用语法

这是最常见也最容易出错的地方,确保你的 list_artlist.htm 模板文件中的调用代码完全正确。

标准写法：

{dede:list pagesize='10'}
    <li>
        <a href="[field:arcurl/]">[field:title/]</a>
        <span>[field:pubdate function="MyDate('Y-m-d',@me)"/]</span>
    </li>
{/dede:list}

关键点检查：

1. 标签名称：确保是 {dede:list} 和 {/dede:list}，不要写成 {dede:arclist} 或其他。
2. 属性：pagesize 用于控制每页显示的文章数量，建议加上，如 pagesize='10'。
3. 字段调用用 [field:title/]，文章链接用 [field:arcurl/]，这些是 list 标签下的标准字段。
4. 闭合标签：必须有 {/dede:list} 来结束循环，否则会导致页面显示异常。

第二步：检查栏目是否正确绑定了列表模板

这是导致调用不出来的第二大原因,即使你的模板写得再对，如果栏目没有使用它，那也是徒劳。

1. 进入后台：登录织梦后台。
2. 找到栏目：在左侧菜单点击【栏目管理】，然后找到你想要显示文章列表的那个栏目。
3. 编辑栏目：点击该栏目右侧的【修改】按钮。
4. 检查模板设置：
   • 找到 列表模板 (List Template) 这一栏。
   • 确保这里选择的模板文件名,和你第一步中编辑的文件名 完全一致（包括大小写和后缀 .htm）。
   • 你模板文件是 /templets/default/list_artlist.htm，那么这里就应该填写 list_artlist.htm。

第三步：检查栏目内容是否为空或存在逻辑问题

问题出在数据本身。

1. 检查栏目是否有文章：
   • 在【栏目管理】中，将鼠标悬停在那个栏目名称上，浏览器状态栏会显示一个链接，通常是 plus/list.php?tid=XX。
   • 点击这个链接直接访问栏目页,如果页面显示“暂无文章”，那说明这个栏目下确实没有发布任何文章，或者文章没有通过审核。
2. 检查文章状态：
   • 进入【所有档案】，检查该栏目下的文章是否都处于“已审核”状态，如果文章是“待审核”状态，在前台是看不到的。
3. 检查栏目类型：
   • 在【修改栏目】页面，检查栏目的“栏目类型”。
   • 如果类型是“外部链接”或“单页文档”，那么它就无法调用文章列表，必须将其设置为“栏目”（普通栏目）。

第四步：检查模板文件路径和权限

1. 文件路径：确保你的模板文件（如 list_artlist.htm）位于正确的目录下，通常是 /你的网站目录/templets/你的模板名称/。
2. 文件权限：确保Web服务器（如Apache或Nginx）对该模板文件有读取权限，你可以尝试在FTP或文件管理器中，将模板文件的权限设置为 644。
3. 编码问题：请务必使用 UTF-8 无BOM格式 来保存你的模板文件，使用记事本等工具保存时，一定要注意选择这个格式，否则很容易导致乱码或标签无法解析。

第五步：检查是否有缓存或插件冲突

1. 清除缓存：

   这是最简单也最有效的“万能”方法之一，登录织梦后台，点击顶部菜单的【系统】 -> 【清除缓存】 -> 【一键更新缓存】，然后点击【开始执行】，执行完毕后，刷新你的前台页面看看。

2. 禁用插件：

   某些第三方插件可能会与系统核心标签产生冲突,你可以尝试在后台暂时禁用所有非必要的插件，然后刷新页面，看看问题是否解决，如果解决了，再逐个启用插件来定位是哪个插件引起的问题。

总结与最终方案

如果以上步骤你都仔细检查过,问题依然存在，可以尝试这个“终极”排查方法：

1. 创建一个最简单的测试页面：

   • 在 /templets/default/ 目录下，新建一个文件，命名为 test_list.htm。
   • 在文件中只写入最简单的 list 标签代码：

   {dede:list pagesize='5'}
       [field:title]<br />
   {/dede:list}

2. 创建一个测试栏目：

   • 在后台【栏目管理】中，新建一个顶级栏目，命名为“测试”。
   • 在这个“测试”栏目下，随便发布几篇文章。
   • 在修改这个“测试”栏目时，将其“列表模板”设置为 test_list.htm。

3. 访问测试页面：

   • 访问这个“测试”栏目的页面（plus/list.php?tid=XX）。
   • 如果这个简单的页面能正常显示文章标题，说明你的 list 标签功能本身是正常的，问题出在你原来的模板文件或栏目配置上，你需要回到第一步和第二步，仔细对比你的原始模板和栏目设置。
   • 如果这个简单的页面也调不出来，那问题可能比较严重，
     • 数据库损坏：检查数据库是否正常。
     • 文件被修改：检查 /include/taglib/list.lib.php 文件是否存在且内容完整（如果不确定，可以从官方下载一个干净的DedeCMS程序包，覆盖这个文件）。
     • 服务器环境问题：PHP版本过低或缺少必要的PHP扩展。

希望这个详细的排查流程能帮助你解决问题！通常情况下，90%以上的问题都出在前三步。