dede图集调用为何只显示一张图？

下面我将从最常见的原因到排查步骤，为你详细分析和解决这个问题。

最常见的原因：缺少 row 参数

在DedeCMS的标签中,row 参数是用来控制调用条数或数量的，如果你在调用图集标签时没有明确指定 row 值，很多情况下系统会默认只调用一条记录，也就是一张图片。

错误示例 (缺少 row):

{dede:field name='imgurls' /}

这个标签通常用于在内容页显示图集的所有图片,但如果用在列表页或其他自定义循环中，它只会处理第一个图集字段。

正确示例 (指定数量): 如果你想在列表页调用每个图集的 3张 图片，你应该这样写：

{dede:list pagesize='10'}
    <h3><a href="[field:arcurl/]">[field:title/]</a></h3>
    <div class="piclist">
        {dede:field name='imgurls' row='3'}
        <img src="[field:src/]" alt="[field:text/]" width="100" />
        {/dede:field}
    </div>
    <p>[field:description function="cn_substr(@me,100)"/]...</p>
{/dede:list}

关键点： {dede:field name='imgurls' row='3'} 中的 row='3' 告诉系统，从这个图集字段里取出最多3张图片。

其他常见原因及排查方法

如果设置了 row 参数但还是只显示一张图，那么问题可能出在以下几个方面，请逐一排查：

本身的问题

• 上传方式错误： 确保你是通过 “图集管理” -> “增加一个图集” 的方式上传的图片，而不是在普通文章编辑器里上传图片后，再手动把图片地址复制到图集字段里。
• 图集为空或损坏： 检查后台该篇图集文章，里面的图片列表是否为空，或者图片是否已经损坏无法显示，进入后台编辑该图集，看看图片是否都正常存在。
• 只上传了一张图： 这是最简单的情况，检查一下这个图集本身是不是就只上传了一张图片。

标签调用代码问题

• 使用了错误的标签： 在列表页调用图集，应该使用 {dede:list} 或 {dedarclist} 标签包裹，然后在里面使用 {dede:field name='imgurls'} 来调用当前文章的图集。
• tablewidth 和 tableheight 参数冲突： 在一些旧版本或特定模板中，imgurls 标签的 tablewidth 和 tableheight 参数可能会影响图片的输出，如果你不需要设置表格，可以尝试去掉这些参数。
• CSS样式覆盖： 检查你的CSS文件，有可能你的CSS代码（overflow: hidden; 或 display: block;）将后续的图片隐藏了，使用浏览器的“开发者工具”（F12）检查图片元素，看看它们是否存在但被CSS隐藏了。

图片路径问题

• 图片未生成或路径错误： 检查网站根目录下的 /uploads/ 文件夹，对应的图片文件是否真实存在，如果图片存在但路径不正确（例如从本地环境迁移到服务器后路径错误），也会导致只显示第一张（或部分）图片。
• 相对路径与绝对路径： 确保图片的存储方式（在后台“系统” -> “系统基本参数” -> “核心设置”中）和你的调用代码匹配。

标准正确的图集调用代码示例

这里提供几个在不同场景下的标准调用代码,你可以参考使用。

在列表页循环调用，每篇文章显示3张缩略图

这是最常见的需求,代码如下：

{dede:list pagesize='10'}
    <li>
        <!-- 调用图集，最多显示3张 -->
        <div class="pics">
            {dede:field name='imgurls' row='3'}
            <a href="[field:arcurl/]"><img src="[field:src/]" alt="[field:text/]" /></a>
            {/dede:field}
        </div>
        <h2><a href="[field:arcurl/]">[field:title/]</a></h2>
        <p>[field:description function="cn_substr(@me,100)"/]...</p>
    </li>
{/dede:list}

页，调用所有图片（带图集描述）

页模板（article_article.htm）中，通常使用这个标签来展示完整的图集。

{dede:field name='imgurls' alt='暂无图片'}
    <li>
        <a href="[field:src runphp='yes']@me = str_replace('{cmspath}', '', @me);[/field:src]" target="_blank">
            <img src="[field:src runphp='yes']@me = str_replace('{cmspath}', '', @me);[/field:src]" alt="[field:text/]" />
        </a>
        <p>[field:text/]</p>
    </li>
{/dede:field}

注意： 内容页的 imgurls 标签会自动循环输出所有图片，不需要 row 参数。runphp='yes' 的作用是处理图片路径，去掉 {cmspath} 这个占位符，确保路径正确。

在列表页调用，只显示第一张图作为缩略图

如果你只想在列表页显示每篇文章的第一张图作为封面，可以这样写：

{dede:list pagesize='10'}
    <li>
        <!-- 只调用第一张图 row='1' -->
        {dede:field name='imgurls' row='1'}
        <a href="[field:arcurl/]"><img src="[field:src/]" alt="[field:text/]" /></a>
        {/dede:field}
        <h2><a href="[field:arcurl/]">[field:title/]</a></h2>
    </li>
{/dede:list}

终极排查步骤

如果以上方法都无效,请按照以下步骤进行系统排查：

1. 确认图集内容： 进入后台，找到那篇只显示一张图的图集文章，点击“编辑”，在图集管理里看看图片列表是否完整、图片是否正常。这是第一步，也是最重要的一步。
2. 检查调用代码： 复制你正在使用的图集调用标签，确保它包含了 row 参数，并且被正确地放在了 {dede:list} 或 {dede:arclist} 循环标签内部。
3. 清除缓存： 在后台点击“系统” -> “一键更新网站” -> “更新HTML”，勾选“更新所有栏目页”和“更新文档HTML”，然后执行，有时候是缓存问题导致的新代码不生效。
4. 检查源码和CSS： 在浏览器中右键“查看网页源代码”，找到图片部分，看看 <img> 标签是否有多张，如果源码里有，但页面没显示，那99%是CSS样式的问题，用F12开发者工具检查元素，看看是被隐藏了还是溢出了。
5. 尝试更换模板： 如果是在列表页，尝试更换一个默认的DedeCMS模板，看看问题是否解决，如果解决，说明是你当前模板的代码或CSS有问题。

通过以上步骤,你应该能准确定位并解决“Dede图集调用只出一张图”的问题，绝大多数情况下，问题都出在 row 参数缺失 或 本身为空/错误 上。