问题根源分析
图片不显示,无非是以下几个原因:

- 图片路径错误:代码里引用的路径和图片实际存放的路径不一致。
- 标签调用错误:在模板文件中,没有使用正确的标签来调用多图字段。
- 字段配置问题:在后台模型管理中,多图字段的设置可能有问题。
- 服务器权限问题:上传图片后,服务器上的目录或文件没有正确的读取权限。
- 缓存问题:后台或浏览器缓存了旧的错误信息。
详细排查步骤(请按顺序操作)
第一步:检查后台模型字段(最关键的一步)
这是最容易出错的地方,请确保你的自定义模型中“多图”字段的设置完全正确。
- 登录DEDECMS后台。
- 进入 【核心】 -> 【内容模型管理】。
- 找到你当前使用的内容模型(文章模型”),点击后面的 【字段管理】。
- 在字段列表中,找到你的自定义多图字段(
litpic、images或你自定义的字段名)。 - 检查以下设置:
- 字段名:确保是你代码中调用的那个字段名。
- 字段类型:必须是
multiimag(DEDECMS 5.7版本) 或类似的图片集类型。 - 默认值:留空即可。
- **【高级选项】 -> 【上传目录】**:这个非常重要!建议设置一个固定的目录,
uploads/images/multi/。不要留空,留空可能导致路径混乱。 - 【是否支持多图】:确保是“是”。
- 【缩略图选项】:根据你的需求选择,自动生成缩略图”和“当原图大于指定大小时才生成缩略图”比较常用。
操作:如果这里的设置不正确,请修改后保存,然后进入 【系统】 -> 【一键更新网站】,选择“更新数据库”和“更新HTML”,然后执行。
第二步:检查模板文件中的标签调用
确认了后台字段没问题后,我们来检查模板是如何调用这些图片的。
DEDECMS调用多图字段,通常使用 {dede:field.字段名/} 标签,并用 array 函数来分割和循环。

错误的调用方式(常见错误):
{dede:field.images/}
这样直接调用,只会输出图片路径的原始文本, 正确的调用方式(推荐使用):
这是最标准、最灵活的调用方法。 更详细的循环调用(如果你想对每张图进行单独控制): 在这个循环里: 操作:找到你发布内容所使用的模板文件(通常在 这是最容易被忽略,但又很致命的一步。 Linux权限说明: 如果权限不正确,Web服务器(如Apache/Nginx)可能没有权限读取这些文件,导致图片无法显示。 DEDECMS或浏览器会缓存错误的信息。 按照以上五个步骤,90%以上的“DEDECMS自定义多张图片不显示”问题都可以解决。 最终的、最可靠的解决方案组合是: 如果以上所有步骤都操作过,问题依旧存在,那么可能是你的DEDECMS版本存在Bug,或者模板文件有其他冲突,可以考虑在官方论坛或社区搜索类似问题,或者尝试在干净的DEDECMS环境中重现问题来定位原因。a.jpg|b.jpg|c.jpg,并不会显示为 <img>
{dede:field name='images' function='Getimgs(@me, 200, 200, 1)'/}
field name='images':这里的 images 必须和你在后台设置的字段名完全一致。function='Getimgs()':这是DEDECMS内置的函数,专门用来处理多图字段。@me:代表当前字段的原始值(即 a.jpg|b.jpg|c.jpg)。200, 200:分别代表图片的宽度和高度,DEDECMS会自动生成指定尺寸的缩略图,你可以根据需要修改。1:这个参数代表是否显示 <img> 标签。1 是显示,0 则只输出图片路径。{dede:field name='images' function='Getimgs(@me, 200, 200, 1)'}
<a href="[field:src/]" target="_blank">
<img src="[field:src/]" alt="[field:alt text='' /]" width="200" height="200" />
</a>
{/dede:field}

[field:src/]:代表当前循环的这张图片的路径。[field:alt text='' /]:代表图片的alt属性,如果图片没有描述,则留空。templets/你的模板目录/ 目录下),将错误的标签替换为上述正确的标签。第三步:检查图片上传和实际路径
<img> 标签里的 src 属性值是什么。
src 属性是空的、不完整的,或者路径是 ../uploads/... 这种相对路径但无法访问的,说明是路径问题。src 属性是一个完整的、正确的路径(http://你的域名.com/uploads/images/multi/202511/01/a.jpg),但图片仍然打不开,那问题可能出在服务器上。第四步:检查服务器目录和权限
uploads 目录:确保这个目录存在。uploads/images/multi/,那么就要检查这个目录是否存在。uploads 目录以及其下的所有子目录(如 images, multi),将权限修改为 755。a.jpg),将权限修改为 644。
755 (drwxr-xr-x):目录标准权限,所有者有读写执行权限,组用户和其他用户有读和执行权限。644 (-rw-r--r--):文件标准权限,所有者有读写权限,组用户和其他用户只有读权限。第五步:清除缓存
Ctrl + F5 强制刷新页面。F12 打开开发者工具,在 Network (网络) 标签页中勾选 Disable cache (禁用缓存),然后再刷新页面。
总结与最终方案
multiimag,上传目录】设置为一个固定值(如 uploads/images/multi/)。{dede:field name='你的字段名' function='Getimgs(@me, 200, 200, 1)'/}。uploads 目录及其子目录的权限是否为 755,图片文件权限是否为 644。Ctrl + F5 刷新前台页面。
