图片站点地图按网页组织图片:普通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返回该页真实使用的图片,不能把同一张样例图附加到所有文章。修改后重新生成地图,再查原页面条目与相邻正常页面。这里说明接入位置,不建议直接改插件核心文件。
整理的是“这页用了哪些图”,不是媒体库总数
假设一张折叠台灯产品页使用正面图和关节细节图,另有一篇讲关节调整位置的教程,也使用同一张细节图。产品和地址都是教学设定,不代表真实型号、操作说明或已公开页面。

| 网页及其用途 | 这页实际使用的内容图 | 对应关系 |
|---|---|---|
| 产品页,帮助辨认台灯与结构 | 正面图、关节细节图 | 一个网页条目关联两张图 |
| 教程页,解释关节所在位置 | 同一张关节细节图 | 另一个网页条目再次关联该图 |
共享同一张图,可以在两页各自出现;不应因为文件已经列过一次,就从另一张真实使用它的页面中删掉。相反,同一张正面图的多个缩略尺寸,不必仅为增加数量全部当作不同场景堆进去。先保证文件可访问、构图清楚并且与页面内容有关。
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 检查必填地址:一份删掉第一张图的 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&v=2。本地解析后读回的仍是原URL;XML转义与修改真实地址是两回事。Google的地图制作说明要求UTF-8、完整地址与正确转义。自动生成时让XML库处理,别在已转义字符串上重复替换,弄出&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读取成功,但图片还没出现,是地图写错吗?
不一定。先确认读取的是修后的版本,再核页面、文件与访问条件。地图提供发现信息,索引和展示仍是后续处理;重复提交不能替代具体故障排查,也不能保证某张图排名。







