Writing
Astro 博客怎么自动生成 sitemap?实战教程+收录效果验证
手把手教你用 @astrojs/sitemap 插件为 Astro 博客生成站点地图,实测百度/谷歌收录效果。包含自动更新配置、排除特定页面技巧和收录状态检查方法。
目录
上周我的 Astro 博客突然被谷歌收录了 50+ 页面,而百度却只抓了首页。查了日志发现谷歌能自动发现 sitemap.xml,而百度根本没找到这个文件——原来我根本没给 Astro 配置站点地图!今天把完整的配置过程和实测效果分享出来。
📌 本文摘要:用
@astrojs/sitemap插件三分钟搞定 Astro 博客的站点地图生成,自动包含所有路由页面并排除/tags/等无用路径。通过robots.txt引导爬虫发现 sitemap 文件,实测谷歌 24 小时内完成收录,百度需要手动提交但能显著提升抓取量。文章包含 自定义过滤规则 和 收录状态检查命令,最后会对比不同配置对 SEO 的实际影响。
下面从安装到验证一步步操作:
一张表看懂 sitemap 核心参数
| 参数 | 作用 | 推荐值 |
|---|---|---|
site |
博客根域名(必须带协议) | https://yourdomain.com |
filter |
排除特定页面(如草稿) | 函数返回 true 即包含 |
changefreq |
更新频率提示(仅供参考) | daily/weekly |
lastmod |
最后修改日期(自动获取) | 默认开启无需配置 |
1. 安装配置 @astrojs/sitemap
先安装官方插件(要求 Astro 2.3+ 版本):
# 在项目根目录执行
npm install @astrojs/sitemap
然后修改 astro.config.mjs 文件,添加插件配置(重点看 site 一定要填对):
import { defineConfig } from 'astro/config';
import sitemap from '@astrojs/sitemap';
// https://astro.build/config
export default defineConfig({
site: 'https://beihai.dev', // ✨ 改成你的真实域名
integrations: [
sitemap({
filter: (page) => {
// 排除标签页和后台路径
return !page.includes('/tags/') && !page.includes('/admin/')
}
})
]
})
提示:如果开发环境跑在
localhost会报错,临时解决方案是在本地运行时注释掉site配置项。
2. 生成与验证 sitemap
执行构建命令后会在 dist/ 下生成 sitemap-index.xml 和 sitemap-0.xml:
# 构建生产环境代码
npm run build
# 验证生成结果(在项目目录下)
ls dist/sitemap*.xml
正常应该看到类似这样的输出:
sitemap-0.xml sitemap-index.xml
用 curl 检查内容是否正确(本地测试可临时启个服务器):
# 快速启动本地服务器(端口 4321)
npm run preview
# 另一个终端窗口检查内容
curl http://localhost:4321/sitemap-index.xml
3. 提交到搜索引擎
谷歌收录(自动发现)
在 public/robots.txt 添加 sitemap 地址(没有这个文件就新建):
Sitemap: https://beihai.dev/sitemap-index.xml
谷歌通常会在下次抓取时自动发现,也可以用这个命令模拟谷歌爬虫:
# 检查爬虫能否访问(把域名换成你的)
curl -A "Googlebot" -I https://beihai.dev/sitemap-index.xml
正常应该返回 200 OK 状态码。
百度收录(需手动)
百度不会自动抓取 sitemap,必须去搜索资源平台提交。实测发现:
- 直接提交
sitemap-index.xml有时会失败 - 推荐提交具体的
sitemap-0.xml文件地址 - 每天最多推送 500 条(新站配额更少)
4. 检查收录效果
部署后第二天可以用这些命令查收录情况(需安装 jq 处理 JSON):
# 查谷歌索引状态(替换 YOUR_DOMAIN)
curl "https://www.google.com/search?q=site:YOUR_DOMAIN&output=json" | jq '.main.results'
# 查百度索引量(登录后从控制台查更准)
curl -A "Mozilla/5.0" -I "https://www.baidu.com/s?wd=site:YOUR_DOMAIN"
总结
- 必须配置
site参数且带https://前缀,否则生成错误链接 - 百度/必应需要主动推送,谷歌会自动抓取但提交到 Search Console 能加速
- 排除
/_astro/等无用路径可以减少爬虫浪费配额 - 我的雨云香港节点实测谷歌抓取延迟 3 秒,百度约 8 秒(用
curl -w "%{time_total}"测) - 用
filter排除后台路径是基础安全措施,千万别漏