微信小程序的 sitemap.json
是用于**搜索引擎优化(SEO)**的配置文件,它告诉搜索引擎你的小程序中哪些页面可以被收录、如何抓取以及优先级如何。通过合理配置 sitemap.json
,可以提升小程序在微信搜索、百度、Google 等搜索引擎中的曝光度。
一、sitemap.json 文件作用
- 指导搜索引擎爬虫抓取小程序页面
- 声明页面更新频率和权重
- 控制是否允许搜索引擎收录特定页面
- 提升小程序在搜索结果中的可见性
二、sitemap.json 的完整示例(含详细注释)
{
// 小程序 sitemap 协议版本号(固定值)
"version": "0.1",
// 配置小程序页面可被搜索引擎抓取的规则
"siteindex": [
{
// 页面路径(相对 pages 目录下的路径,不带后缀)
"path": "pages/index/index",
// 是否允许该页面被收录(true:允许;false:禁止)
"userAllow": true,
// 页面优先级(0.0 ~ 1.0,数值越大优先级越高)
"priority": 0.9,
// 页面更新频率(可选值见下文)
"changefreq": "daily"
},
{
"path": "pages/logs/logs",
"userAllow": true,
"priority": 0.7,
"changefreq": "weekly"
}
],
// 可选字段:是否启用自动抓取(默认 false)
"autoIndex": false,
// 可选字段:设置默认抓取行为(当没有为某个页面单独配置时使用)
"defaultConfig": {
"userAllow": true,
"priority": 0.5,
"changefreq": "monthly"
}
}
三、各配置项详解与可选值说明
1. version
- 类型:String
- 固定值:
"0.1"
- 说明:当前 sitemap 协议版本号,必须填写
2. siteindex
- 类型:Array<{ path, userAllow, priority, changefreq }>
- 说明:每个对象代表一个页面的抓取规则
子配置项:
子项 | 类型 | 可选值 | 说明 |
---|---|---|---|
path | String | - | 页面路径(如 "pages/index/index" ,不带后缀) |
userAllow | Boolean | true / false | 是否允许搜索引擎抓取 |
priority | Number | 0.0 ~ 1.0 | 页面优先级,数字越大越重要 |
changefreq | String | always , hourly , daily , weekly , monthly , yearly , never | 页面更新频率 |
3. autoIndex
- 类型:Boolean
- 默认值:
false
- 说明:
true
:自动抓取所有页面false
:仅抓取siteindex
中明确列出的页面
4. defaultConfig
- 类型:Object
- 子项包括
userAllow
、priority
、changefreq
- 说明:未在
siteindex
中显式配置的页面将使用此默认配置
四、sitemap.json 配置注意事项
- ✅ 必须放在项目根目录下
- ✅ 不要遗漏
version
字段,否则可能无法生效 - ✅
path
路径应与app.json
中的pages
路径一致 - ✅ 若希望全部页面都被抓取,可设置
autoIndex: true
并配合defaultConfig
- ✅ 不建议将后台管理页、登录页等设为
userAllow: true
- ✅ 修改后需重新上传小程序并等待搜索引擎抓取更新
五、配置方式步骤说明
步骤一:创建 sitemap.json
文件
将上述示例内容复制到项目根目录下新建的 sitemap.json
文件中。
步骤二:修改配置内容
根据你的小程序页面路径,添加需要被抓取的页面,并设置 userAllow
、priority
和 changefreq
。
步骤三:配置 app.json
确保在 app.json
中指定了 sitemapLocation
:
{
"sitemapLocation": "sitemap.json"
}
步骤四:上传小程序代码
提交审核或发布时,搜索引擎会根据 sitemap.json
抓取页面。
六、sitemap.json 总结表格
配置项 | 类型 | 可选值/示例 | 说明 |
---|---|---|---|
version | String | "0.1" | 固定值,必填 |
siteindex | Array | [ { path: "pages/index/index", userAllow: true, priority: 0.8, changefreq: "daily" } ] | 页面抓取规则列表 |
[path](file://D:\workspace\me\rbac2024\read\后台系统\shop-api\itmk-base-web\src\main\java\com\itmk\web\sys_menu\entity\MenuVo.java#L14-L14) | String | "pages/index/index" | 页面路径(不带后缀) |
userAllow | Boolean | true / false | 是否允许抓取 |
priority | Number | 0.0 ~ 1.0 | 页面优先级 |
changefreq | String | always , hourly , daily , weekly , monthly , yearly , never | 页面更新频率 |
autoIndex | Boolean | true / false | 是否自动抓取所有页面 |
defaultConfig | Object | { userAllow: true, priority: 0.5, changefreq: "monthly" } | 默认抓取配置 |
七、总结
sitemap.json
是微信小程序 SEO 的关键配置文件之一,通过它可以:
- 明确指定哪些页面可以被抓取
- 设置页面优先级和更新频率
- 控制抓取策略,避免敏感页面被收录
合理配置 sitemap.json
,有助于提升小程序在搜索引擎中的收录率和排名表现。如果你正在开发一个面向公众的小程序,强烈建议你正确配置并维护这个文件。
如需我帮你生成一份适合你项目的 sitemap.json
配置模板,请提供你的页面路径结构~