[{"data":1,"prerenderedAt":25},["ShallowReactive",2],{"doc-seo":3},{"slug":4,"title":5,"description":6,"lastmod":7,"toc":8,"html":24},"seo","robots 与 sitemap","自动生成的 robots.txt、sitemap.xml，登记页面和维护 lastmod。","2026-10-30",[9,11,13,15,17,20,22],{"id":10,"text":10},"生成结果",{"id":12,"text":12},"文件",{"id":14,"text":14},"登记页面",{"id":16,"text":16},"文档自动收录",{"id":18,"text":19},"写-lastmod","写 lastmod",{"id":21,"text":21},"站点地址",{"id":23,"text":23},"检查","\u003Cp>\u003Ccode>\u002Frobots.txt\u003C\u002Fcode> 和 \u003Ccode>\u002Fsitemap.xml\u003C\u002Fcode> 由模板自动生成，不用手写静态文件。robots 允许抓取并指向 sitemap；sitemap 列出公开页面，告诉搜索引擎站里有哪些地址、哪些内容更新过。\u003C\u002Fp>\n\u003Ch2 id=\"生成结果\">生成结果\u003C\u002Fh2>\n\u003Cpre>\u003Ccode class=\"language-xml\">&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;\n&lt;urlset xmlns=&quot;http:\u002F\u002Fwww.sitemaps.org\u002Fschemas\u002Fsitemap\u002F0.9&quot;&gt;\n  &lt;url&gt;&lt;loc&gt;https:\u002F\u002Fexample.com\u002F&lt;\u002Floc&gt;&lt;\u002Furl&gt;\n  &lt;url&gt;&lt;loc&gt;https:\u002F\u002Fexample.com\u002Fdocs\u002Fseo&lt;\u002Floc&gt;&lt;lastmod&gt;2026-10-30&lt;\u002Flastmod&gt;&lt;\u002Furl&gt;\n&lt;\u002Furlset&gt;\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>标签\u003C\u002Fth>\n\u003Cth>含义\u003C\u002Fth>\n\u003Cth>是否必填\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>&lt;loc&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>页面的完整地址\u003C\u002Ftd>\n\u003Ctd>必填，模板自动拼接\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>&lt;lastmod&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>正文最后一次实质修改的日期\u003C\u002Ftd>\n\u003Ctd>可选，写了才输出\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>不输出 \u003Ccode>priority\u003C\u002Fcode>、\u003Ccode>changefreq\u003C\u002Fcode>，Google 不使用这两个字段（\u003Ca href=\"https:\u002F\u002Fdevelopers.google.com\u002Fsearch\u002Fdocs\u002Fcrawling-indexing\u002Fsitemaps\u002Fbuild-sitemap\">Google 说明\u003C\u002Fa>，2026-10-30）。\u003C\u002Fp>\n\u003Ch2 id=\"文件\">文件\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>位置\u003C\u002Fth>\n\u003Cth>内容\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>shared\u002Fsite-pages.ts\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>手动登记的页面和它们的 \u003Ccode>lastmod\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>content\u002Fdocs\u002F*.md\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>文档的 \u003Ccode>lastmod\u003C\u002Fcode> 写在每篇元信息里\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>nuxt.config.ts\u003C\u002Fcode> 的 \u003Ccode>sitemapDocs\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>构建时算出的文档条目，不用手改\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>server\u002Fseo\u002Fdiscovery.ts\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>生成 robots 和 sitemap、检查日期\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>server\u002Froutes\u002F\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>robots.txt.get.ts\u003C\u002Fcode>、\u003Ccode>sitemap.xml.get.ts\u003C\u002Fcode> 两个路由\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2 id=\"登记页面\">登记页面\u003C\u002Fh2>\n\u003Cp>默认登记了首页、定价（中英文各一条）、隐私和条款：\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-ts\">export const sitemapPages: readonly SitemapPage[] = [\n  { path: &#39;\u002F&#39; },\n  { path: &#39;\u002Fzh&#39; },\n  { path: &#39;\u002Fpricing&#39; },\n  { path: &#39;\u002Fzh\u002Fpricing&#39; },\n  { path: &#39;\u002Fprivacy&#39; },\n  { path: &#39;\u002Fterms&#39; },\n]\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cul>\n\u003Cli>新增公开页面后在这里加一条。sitemap 不会扫描 \u003Ccode>app\u002Fpages\u003C\u002Fcode>，没登记的页面不会出现。\u003C\u002Fli>\n\u003Cli>多语言页面每种语言各写一条：英文无前缀，中文在 \u003Ccode>\u002Fzh\u003C\u002Fcode> 下。在 \u003Ccode>i18n.pages\u003C\u002Fcode> 里关掉语言路由的页面（如隐私、条款）只写一条。\u003C\u002Fli>\n\u003Cli>不登记登录、注册、账号、支付回跳，以及未完成或 \u003Ccode>noindex\u003C\u002Fcode> 的页面。\u003C\u002Fli>\n\u003Cli>路径不带域名，也不带查询参数和结尾斜杠。\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"文档自动收录\">文档自动收录\u003C\u002Fh2>\n\u003Cp>文档不在 \u003Ccode>site-pages.ts\u003C\u002Fcode> 里登记。构建时同时满足两条才收录：\u003C\u002Fp>\n\u003Col>\n\u003Cli>\u003Ccode>app\u002Fpages\u002Fdocs\u003C\u002Fcode> 还在，也就是站点保留了文档页；\u003C\u002Fli>\n\u003Cli>\u003Ccode>content\u002Fdocs\u003C\u002Fcode> 里至少有一篇文章。\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>满足时加入 \u003Ccode>\u002Fdocs\u003C\u002Fcode> 和每篇 \u003Ccode>\u002Fdocs\u002F&lt;slug&gt;\u003C\u002Fcode>，否则一条都不列。复制成新产品后删掉文档页，sitemap 里也不会留下 404 地址。\u003C\u002Fp>\n\u003Cp>文档条目在构建时算好，因为 Worker 运行时读不到 \u003Ccode>content\u002Fdocs\u003C\u002Fcode>。新增或删除文章后要重新构建；开发时重启 \u003Ccode>npm run dev\u003C\u002Fcode>。\u003C\u002Fp>\n\u003Ch2 id=\"写-lastmod\">写 lastmod\u003C\u002Fh2>\n\u003Cp>普通页面写在 \u003Ccode>site-pages.ts\u003C\u002Fcode>：\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-ts\">{ path: &#39;\u002Fpricing&#39;, lastmod: &#39;2026-10-30&#39; },\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>文档写在元信息里：\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-markdown\">---\ntitle: 快速开始\ndescription: 一句话简介\nlastmod: 2026-10-30\n---\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>格式只接受 \u003Ccode>YYYY-MM-DD\u003C\u002Fcode>。不写就不输出 \u003Ccode>&lt;lastmod&gt;\u003C\u002Fcode>，模板默认的页面都没有写。\u003C\u002Fp>\n\u003Ch3 id=\"什么时候改\">什么时候改\u003C\u002Fh3>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>要改\u003C\u002Fth>\n\u003Cth>不改\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>正文、价格、套餐、条款内容变了\u003C\u002Ftd>\n\u003Ctd>改样式、颜色、排版\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>新增或删掉一个段落、一节说明\u003C\u002Ftd>\n\u003Ctd>重构组件、升级依赖\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>修正会影响读者理解的错误\u003C\u002Ftd>\n\u003Ctd>修错别字、改页头页脚\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>\u003Ccode>\u002Fdocs\u003C\u002Fcode> 目录页不写日期。中英文页面分别写，只改了一种语言就只改那一条。\u003C\u002Fp>\n\u003Ch3 id=\"为什么不自动\">为什么不自动\u003C\u002Fh3>\n\u003Cp>构建时间每次发版都会变，Git 提交时间在改样式、重构时也会变，两者都不能代表内容更新。Google 只在 \u003Ccode>lastmod\u003C\u002Fcode> 长期准确时才参考它，所以模板只输出手写的日期。\u003C\u002Fp>\n\u003Ch3 id=\"写错会怎样\">写错会怎样\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>文档元信息格式不对：\u003Ccode>npm run docs:build\u003C\u002Fcode> 报错，构建中止。\u003C\u002Fli>\n\u003Cli>\u003Ccode>site-pages.ts\u003C\u002Fcode> 里日期无效（如 \u003Ccode>2026-02-30\u003C\u002Fcode>）或晚于今天：访问 \u003Ccode>\u002Fsitemap.xml\u003C\u002Fcode> 报错。发布前按下面的方法检查一次。\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2 id=\"站点地址\">站点地址\u003C\u002Fh2>\n\u003Cp>两个文件里的域名来自 \u003Ccode>NUXT_PUBLIC_SITE_URL\u003C\u002Fcode>，不跟随请求的 Host。本地默认 \u003Ccode>http:\u002F\u002F127.0.0.1:3000\u003C\u002Fcode>；\u003Ccode>npm run deploy:production\u003C\u002Fcode> 在构建后把正式域名写进 Worker 变量（见\u003Ca href=\"\u002Fdocs\u002Fdeploy\">部署\u003C\u002Fa>）。\u003C\u002Fp>\n\u003Cp>所以这两个文件在每次请求时生成，不预渲染。预渲染发生在写入正式域名之前，文件里会留下本地地址。\u003C\u002Fp>\n\u003Cp>如果放了 \u003Ccode>public\u002Frobots.txt\u003C\u002Fcode>，静态文件会先于路由返回，生成的 robots 就不生效，不要再加回来。\u003C\u002Fp>\n\u003Ch2 id=\"检查\">检查\u003C\u002Fh2>\n\u003Cp>本地：\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">npm run dev\ncurl http:\u002F\u002F127.0.0.1:3000\u002Frobots.txt\ncurl http:\u002F\u002F127.0.0.1:3000\u002Fsitemap.xml\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>用正式地址预览构建产物：\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">npm run build\nnpx wrangler dev --cwd .output --port 8798 --var NUXT_PUBLIC_SITE_URL:https:\u002F\u002Fexample.com\ncurl http:\u002F\u002F127.0.0.1:8798\u002Fsitemap.xml\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>确认几点：\u003C\u002Fp>\n\u003Cul>\n\u003Cli>域名是正式域名，不是 \u003Ccode>127.0.0.1\u003C\u002Fcode>；\u003C\u002Fli>\n\u003Cli>每个地址打开都是 200，没有登录页、账号页；\u003C\u002Fli>\n\u003Cli>改过的页面日期正确，没改的页面日期不变。\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>发布后用 \u003Ccode>curl https:\u002F\u002F你的域名\u002Fsitemap.xml\u003C\u002Fcode> 再看一次。需要时在 Google Search Console 提交 \u003Ccode>https:\u002F\u002F你的域名\u002Fsitemap.xml\u003C\u002Fcode>；以后的更新会被自动读取，不用每次重新提交。\u003C\u002Fp>\n",1795050222295]