HTML站点地图是供用户阅读的语义化导航页，须用<h2><ul><li><a>等标准标签构建，禁用XML结构；XML站点地图须程序生成、严格校验格式与URL有效性，超限需分片并通过sitemapindex.xml聚合。
HTML站点地图不是XML，别往里塞<url>标签
HTML版sitemap本质是给人看的导航页，不是给爬虫解析的机器文件。常见错误是直接把sitemap.xml里的<url><loc>结构复制进HTML，结果浏览器渲染为空白或报错——HTML文档不认XML命名空间，<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">这种写法在<body>里纯属无效代码。
正确做法是用标准HTML语义化标签组织链接：
- 一级分类用
<h2>，每个分类下用<ul><li><a href="/about/">关于我们</a></li></ul> - 路径统一用根相对路径（以
/开头），比如/products/widget/，别写./products/widget/index.html - 过滤掉
/admin/、/api/、/test-这类非公开路径，前端没权限控制时，至少别主动暴露 - 页面超过30个链接就考虑用
<details><summary>产品中心</summary>...</details>折叠，别堆满一屏
XML版sitemap必须程序生成，手动写=白写
sitemap.xml不是手敲出来的，搜索引擎根本不认。你本地编辑一个<url><loc>https://example.com/home</loc></url>文件，上传后Google Search Console大概率提示“格式错误”或“未发现有效URL”。原因很实在：它需要严格校验XML结构、编码（UTF-8）、字段逻辑（比如<lastmod>不能是未来时间）、以及URL是否真实可访问。
生成方式取决于你的技术栈：
立即学习“前端免费学习笔记（深入）”；
- 静态站（如Hugo/Next.js输出的
dist目录）：用Python脚本递归读取./dist，跳过.git、_redirects、404.html，把/about/index.html转成/about/再写入XML - 动态站（Node.js/PHP/Python后端）：从路由注册表或数据库查出所有启用状态的URL，别依赖HTML页面里的
<a>链接——那些可能是废弃的或需登录才可见 - CMS（WordPress等）：确认插件已启用且配置了“包含已发布页面+排除草稿”，默认设置常漏掉自定义文章类型
大站必须分片，单个sitemap.xml超5万URL会失效
硬性限制：单个sitemap.xml最多5万个URL，未压缩体积不能超50MB。超出后，Google会静默丢弃超出部分，不会报错也不会警告——你以为全提交了，其实后半截根本没进索引队列。
解决方案不是“加大服务器内存”，而是拆分+聚合：
- 按模块拆：比如
sitemap-posts.xml（文章）、sitemap-products.xml（商品）、sitemap-pages.xml（单页） - 用
sitemapindex.xml聚合，内容形如：<?xml version="1.0" encoding="UTF-8"?> <sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"> <sitemap> <loc>https://example.com/sitemap-posts.xml</loc> </sitemap> <sitemap> <loc>https://example.com/sitemap-products.xml</loc> </sitemap> </sitemapindex> - 在
robots.txt里只写Sitemap: https://example.com/sitemapindex.xml，别列一堆单独的sitemap-*.xml
验证不是走流程，是看Search Console当场报错行号
上传sitemap.xml后，别只打开浏览器看能不能访问。真正有效的验证动作只有一个：把地址粘进Google Search Console的Sitemaps工具里提交。它会在几秒内返回具体错误，比如“第127行缺少<loc>”、“第452行<lastmod>格式非法”——这种定位到行号的反馈，比任何本地XML校验器都准。
容易被忽略的点：
-
sitemap.xml必须放在网站根目录，https://example.com/sitemap.xml，不是/seo/sitemap.xml或/sitemap_index.xml - 所有URL必须和
robots.txt中Allow/Disallow规则一致，否则Search Console会标红“Blocked by robots.txt” - CDN缓存可能让你看到旧版本，提交前先
curl -I https://example.com/sitemap.xml确认HTTP状态码是200且Last-Modified头已更新
