知识库文章

图片站点地图怎么做?把网页和图片地址正确写进XML

文章摘要
图片站点地图写的是网页与图片的对应关系。用产品页和教程页给出完整XML,讲清现有CMS检查、CDN跨域、旧字段、转义及上线验收,不把提交成功当作图片已收录。

本页阅读目录

台灯网页与整体细节照片资料整理的原创教学场景

图片站点地图按网页组织图片:普通loc写网页地址,image:image里的image:loc写该页使用的图片文件地址,并在XML顶部声明图片命名空间。它可以并入现有站点地图,也可以独立生成;先检查网站现在有没有正确输出,不必看见“图片地图”就再装一个插件。

后台提交地图显示成功,产品图片却没在搜索里出现,很容易让人想“是不是还缺一个文件”。先分清三个问题:地图有没有列对图片,Google是否能访问页面和文件,以及后来是否索引、选择展示。前一个问题可以立即检查,后两个不能由“提交成功”代替。

下面用两张教学页面写出完整XML,并实际解析回读其中的关系。若需要先找到WordPress地图入口和普通子地图,可看XML Sitemap生成与三层排错;本篇继续处理图片扩展。

先查现有页面条目,别只找image-sitemap文件名

打开当前生成器提供的文章或产品子地图,找到一张确实含有内容图片的公开页,再查看这个网页条目下有没有image:image和图片地址。浏览器可能把XML显示成表格,需要查看原始响应或源码,才能确认实际字段。

没有一个单独叫image-sitemap.xml的文件,不代表没有图片信息。Yoast的官方说明就展示了在页面条目里包含图片的方式,也说明某些主题或建站器模块可能需要额外接入。先查具体页面、具体图片有没有被现有生成器识别,再决定修哪里。

如果正文图片有、地图里却只有特色图,检查模块保存位置和生成器支持;如果地图有旧域名图片,查输出来源与迁移,而不是先上传一份手工新清单。已有正确记录时,继续维护同一来源,能少掉一套长期同步工作。

以Yoast为例,先选定一个缺图页面,保存三项信息:网页URL、实际图片文件URL,以及图片来自普通正文还是某个建站器模块。普通正文图片能列出、只有该模块漏图时,应请维护者检查该模块与地图生成器的对接,确认生成器能否识别模块中的图片;不能仅给维护者一句“图片数不够”。Yoast为额外图片提供wpseo_sitemap_urlimages过滤接口,维护者需要按当前文章ID返回该页真实使用的图片,不能把同一张样例图附加到所有文章。修改后重新生成地图,再查原页面条目与相邻正常页面。这里说明接入位置,不建议直接改插件核心文件。

整理的是“这页用了哪些图”,不是媒体库总数

假设一张折叠台灯产品页使用正面图和关节细节图,另有一篇讲关节调整位置的教程,也使用同一张细节图。产品和地址都是教学设定,不代表真实型号、操作说明或已公开页面。

台灯整体与关节细节两类图像用途的AI教学示意
AI教学示意:整体图与关节细节承担不同说明任务,不对应真实商品型号或参数。
网页及其用途这页实际使用的内容图对应关系
产品页,帮助辨认台灯与结构正面图、关节细节图一个网页条目关联两张图
教程页,解释关节所在位置同一张关节细节图另一个网页条目再次关联该图

共享同一张图,可以在两页各自出现;不应因为文件已经列过一次,就从另一张真实使用它的页面中删掉。相反,同一张正面图的多个缩略尺寸,不必仅为增加数量全部当作不同场景堆进去。先保证文件可访问、构图清楚并且与页面内容有关。

Logo、装饰纹理、后台测试图与未公开资料,也不能因为存在媒体库就全部写进公开图片地图。这里列的是准备让Google发现、且确实属于这些公开页面的图片。地图不会替页面补出原来没有的信息或使用关系。

一份可复制的完整XML

下面把上表写成一份独立示例,保存时使用UTF-8。上线前替换为真实、允许公开的页面及图片URL;example.com不是要提交的站点。

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
        xmlns:image="http://www.google.com/schemas/sitemap-image/1.1">
  <url>
    <loc>https://example.com/products/folding-lamp/</loc>
    <image:image>
      <image:loc>https://example.com/media/lamp-front.webp</image:loc>
    </image:image>
    <image:image>
      <image:loc>https://example.com/media/lamp-joint.webp</image:loc>
    </image:image>
  </url>
  <url>
    <loc>https://example.com/guides/lamp-joint/</loc>
    <image:image>
      <image:loc>https://example.com/media/lamp-joint.webp</image:loc>
    </image:image>
  </url>
</urlset>

第一种loc的上级是url。第一个字段写网页地址。带image:前缀的loc位于image:image内部,说的是“这页用了哪张图片文件”。图片的WordPress附件介绍页仍是网页,不要把它误当成原图片文件地址。

两种命名空间分别让解析器识别普通地图与图片扩展。只加前缀、不声明xmlns:image,不能算完整XML。这里沿用Google图片地图规范的结构,页面与图片地址均为示例,制作时请换成自己的正式URL。

用自己的XML运行一次检查

把待检查文件保存为image-sitemap.xml,再把下面代码保存为同一文件夹中的check_image_sitemap.py。需要Python 3,使用标准库,无需安装额外包。程序只读取本地XML,不请求网站,也不修改原文件。

import sys
import xml.etree.ElementTree as ET
from urllib.parse import urlsplit

NS = {
    'sm': 'http://www.sitemaps.org/schemas/sitemap/0.9',
    'image': 'http://www.google.com/schemas/sitemap-image/1.1',
}

def validate_address(address, label):
    try:
        parsed = urlsplit(address)
        valid = parsed.scheme in ('http', 'https') and parsed.hostname
    except ValueError:
        valid = False
    if not valid:
        raise ValueError(f'{label}: 地址为空或不是完整HTTP/HTTPS地址: {address!r}')

def check(filename):
    root = ET.parse(filename).getroot()
    if root.tag != '{' + NS['sm'] + '}urlset':
        raise ValueError('需要网页子地图urlset,不是sitemapindex或其他文件')
    pages = root.findall('sm:url', NS)
    relations = 0
    unique_images = set()
    for item in pages:
        page = item.findtext('sm:loc', default='', namespaces=NS).strip()
        validate_address(page, '网页 loc')
        images = []
        for index, image in enumerate(item.findall('image:image', NS), 1):
            locs = image.findall('image:loc', NS)
            label = f'{page} 第{index}张图'
            if len(locs) != 1:
                raise ValueError(f'{label}: 需要恰好一个 image:loc')
            address = (locs[0].text or '').strip()
            validate_address(address, label + ' image:loc')
            images.append(address)
        print(page)
        for address in images:
            print('  图片: ' + address)
        print('  此页图片数: ' + str(len(images)))
        relations += len(images)
        unique_images.update(images)
    print(f'网页={len(pages)}; 网页与图片关联={relations}; 不同图片文件={len(unique_images)}')
    return len(pages), relations, len(unique_images)

if __name__ == '__main__':
    if len(sys.argv) != 2:
        raise SystemExit('用法: python check_image_sitemap.py image-sitemap.xml')
    try:
        check(sys.argv[1])
    except (OSError, ET.ParseError, ValueError) as error:
        raise SystemExit('检查未完成: ' + str(error))

在该文件夹打开终端,运行python check_image_sitemap.py image-sitemap.xml;文件在别处时,将第二个参数换成实际路径,路径含空格就加引号。它会逐页打印网页地址、图片地址和本页图片数,最后输出总数。用上面的完整XML运行,最后一行为网页=2; 网页与图片关联=3; 不同图片文件=2。

本次把文中XML交给本地XML解析器,实际读回两张网页、三条网页与图片关联,以及两份不同图片文件。产品页读回正面图和关节图,教程页仍读回同一关节图;共享关系没有因为“去重”而丢掉。

两个网页分别关联整体图和共享关节图的三条关系示意
原创关系示意:产品页关联两图,教程页再次关联同一细节图。图只解释关系;示例XML的实际回读结果见正文,不用这张图代替解析证据。

移除图片命名空间声明,或把地址里的 & 原样写入 XML,都会让解析失败。另用两份 XML 检查必填地址:一份删掉第一张图的 image:loc,保留外层 image:image;另一份保留标签但留空。两份都应报出产品页网址和「第1张图」,且不会输出通过的汇总。

换成自己的文件时,按输出定位:

  • 提示找不到文件:检查当前终端目录、路径和实际扩展名,不要把.xml.txt当作XML文件名。
  • 提示unbound prefix或给出行列号:到该位置检查前缀声明、标签闭合与未转义字符。行列是语法位置,不是Google的索引状态。
  • 提示需要urlset:你可能拿到了地图索引;先打开索引中对应网页子地图再检查。
  • 网页存在但图片数为0:查看那页有没有图片扩展,或xmlns:image的URI是否写对。错误URI也可能是合法XML,却没有被这个脚本识别成Google图片扩展。
  • 提示地址为空或不完整:先在 XML 中搜索报错显示的地址。如果提示地址为空,逐项检查页面loc和图片loc,填写真实完整地址。

总数与预期不同,先看打印出来的具体页面和文件;先确认差的是网页条目、网页与图片的关联,还是不同文件的数量。脚本验证语法、命名空间识别和地址形态,没有访问文件,也不替代后面的页面与图片检查。

如果真实图片URL含有参数,例如?size=large&v=2,写入XML时应成为?size=large&amp;v=2。本地解析后读回的仍是原URL;XML转义与修改真实地址是两回事。Google的地图制作说明要求UTF-8、完整地址与正确转义。自动生成时让XML库处理,别在已转义字符串上重复替换,弄出&amp;amp;。

解析成功只证明这份示例的结构和回读结果。它没有访问example.com,也没有证明Google已经接受、抓取或索引图片。自己的文件还要打开对应页面,确认里面实际用了这些图,再请求每个文件,核状态、内容类型与画面;地址写得合法,也可能指向已删除文件或登录页。

CDN、数量与旧字段,分别按哪条规则处理

图片在另一域名,不要把网页loc一起换掉

产品网页可以在主站,图片文件由CDN提供。此时网页loc仍指产品页,image:loc才使用真实图片服务地址,不必为了看起来同域而写一条实际不存在的本地路径。

Google的图片地图文档允许图片地址跨域,并要求确认相关域名在Search Console中得到验证,同时不能用robots规则挡住希望索引的内容。如果使用第三方共享CDN域名,先核是否有可验证的自定义域与相应配置;不能假装拥有服务商整个根域。这是图片地图使用跨域地址的规范条件,不等于“所有未验证CDN图片都绝不可能被索引”。

每页最多1000项,不是整站只许1000张图

当前规范限制的是每个url条目中的image:image数量。普通地图文件还受自身规模规则约束,大站按现有生成器拆分即可,通用规则见前面的Sitemap主教程。

没有必要为了接近上限而把图标、每种缩略尺寸与重复场景都列进去。维护时先检查重要内容图是否对应正确页面,文件是否稳定;“图片记录更多”本身不能证明清单更有用。

不再照搬旧caption、title等扩展字段

当前官方文档已移除image:caption、image:geo_location、image:title和image:license这些旧扩展标签。文中的最小示例保留当前需要的结构,不从旧模板把这些字段整套搬回去。

XML里的旧字段与网页里的可见图注、标题、Alt不是同一个对象。页面仍需要用真实文字讲清图片用途,不能因为旧image:caption不再沿用,就删除对读者有用的正文说明。

上线和更新时,检查清单、页面与文件三处

由现有CMS生成时,优先在原生成流程里修复缺图或错误来源。自建生成器则把经过确认的页面—图片关系作为输入,自动序列化XML并更新;不要把一次手写样本当成以后永远不用维护的成品。

自建版本需要由维护者在服务器上提供一个稳定、公开可读取的XML地址,或接入现有地图索引;保存到电脑上还不算上线。在正确网站资源的GSC中进入“站点地图”,提交正在维护的索引或这份独立地图的真实地址,并核对最终记录。已经由现有索引管理的子地图继续沿原入口维护,不必每换一张图就再创建、提交一份新文件。

文件准备好后,未登录请求真实地图地址,确认返回的是可解析XML。再抽一条页面记录,打开网页与它列出的图片文件:页面实际有图,图片能取得正确内容,两者都没有被意外登录限制、失效地址或访问规则阻挡。普通Sitemap文件位置、索引与GSC提交流程继续用站点地图主教程,无需在这里再建第二套维护方式。

如果产品主图仍只存在于CSS背景里,不要把“列进图片地图”当作页面实现已修好。CSS背景与内容图片的区别会继续说明受支持的HTML入口。文件很大或手机选错尺寸,则进入图片性能优化。

更新产品页或换图后,核清单是否仍列旧地址、当前页面是否还在用旧图。共享关节图替换时,产品页和教程页都属于受影响范围;只更新其中一条关系,另一页仍可能指向旧文件。迁移中还应按实际旧引用处理,不为追求新鲜每天换图片文件名。

提交后看新的读取状态;后来有没有图片搜索展示和点击,再从GSC图片搜索与落点分析查看。地图读取成功,不代表所列图片均已被索引,报告中的网页也不等于同页每张文件的独立统计。 页面访问或索引仍有异常时,可到技术SEO专题选择相应的检查方法。

若清单已经正确、图片仍无法读取,下一步应查技术SEO审计中的访问与资源问题,而不是再造一份XML。要把图片与页面、内容、数据复查一起安排,可参考谷歌SEO完整流程;刚开始学习图片SEO时,再按谷歌SEO学习路径补相关基础。

常见问题

有很多媒体文件,全部写入图片地图更好吗?

先按实际公开页面与用途整理,不按媒体库总数决定。未公开、测试、装饰和不再使用的文件,不应仅为凑数量成为候选;同一场景的多尺寸也先核真实需要。

同一张图出现在产品页和教程,会算重复错误吗?

不能仅据此判错。它确实服务两页时,可以在各自页面条目中列出。真正要核的是两页有没有实际使用、语境是否合适、地址是否指向那张正确图片。

Google读取成功,但图片还没出现,是地图写错吗?

不一定。先确认读取的是修后的版本,再核页面、文件与访问条件。地图提供发现信息,索引和展示仍是后续处理;重复提交不能替代具体故障排查,也不能保证某张图排名。

我专注 Google SEO、独立站增长与 AI 工作流,实践覆盖 WordPress 外贸 B2B 询盘站和 Shopify DTC 品牌站。从关键词研究、网站架构到内容与技术优化,我关注每一步怎样影响流量、询盘和购买。

本站分享我的项目方法与复盘,说明为什么这样做、具体怎样执行,以及如何判断改动是否有效。

雨果跨境观察员 · 公众号、抖音、小红书同名账号:跨境YOUNG。

学习与查找

从入门开始,或回到问题目录:

关于跨境YOUNG

跨境YOUNG整理WordPress建站、Google SEO与AI SEO / GEO方法,并提供建站、代运营和顾问服务。

需要有人持续推进SEO?

网站已上线,但页面、内容、技术、内链和月度数据没有持续推进?可先诊断范围与优先级,再按月执行与复盘。

最具性价比的服务器

Hostinger 适合预算有限的新站和中小企业 WordPress 网站,托管、备份与基础性能配置比较完整。通过专属链接可享 20% 折扣,购买前再核对机房位置和续费价格。

专属链接含 20% 折扣;跨境YOUNG可能获得佣金,不会增加你的购买成本。