Lazy loaded image
NotionNext 配置教程(示例)
字数 447阅读时长≈ 2 分钟
2026-8-17
2026-8-17
💡
本文是博客配置示例。配置前请先确认项目已使用正确的 Notion 数据库。

配置方式与优先级

NotionNext 的配置通常来自以下位置:
  1. 项目中的 blog.config.js
  1. 所用主题的 config.js
  1. Vercel 环境变量
  1. Notion 内的「配置中心」
配置中心的优先级最高:其中已启用的配置会覆盖 Vercel 环境变量和 blog.config.js 中的同名配置。

使用配置中心

配置中心仅在 NotionNext V4.1.0 及以后版本支持。
  1. 打开博客数据库中的「配置中心」页面。
  1. 在 CONFIG-TABLE 新建或编辑一行配置。
  1. 勾选「启用」;未启用的行不会生效。
  1. 填写配置名与配置值。
  1. 部署后检查博客页面是否按预期更新。

配置表字段

字段
用途
启用
控制该配置是否生效
配置名
配置变量名,例如 AUTHOR
配置值
实际取值,例如作者名、true 或 false
配置备注
用于记录该配置的目的或修改原因
配置附件
当配置值为图片时,在此上传图片文件

注意事项

  • 可用的配置名和值,请以 blog.config.js 与当前主题的 config.js 为准。
  • 并非所有配置都支持写入配置中心;例如 NOTION_PAGE_ID 不支持在此设置。
  • 不要修改配置表的表头,除非你同时清楚项目中对应字段的实现。
  • 重要配置修改后,建议保留备注,方便之后排查。

发布前检查

配置项已勾选「启用」
配置名与项目配置文件完全一致
配置值符合预期格式
已确认没有用配置中心意外覆盖环境变量
已重新部署并在网页端验证

项目仓库:NotionNext
上一篇
下一篇
模板说明