43 lines (27 loc) · 1.02 KB

配置体系说明

配置来源与优先级

同名配置项的优先级：

Notion Config 表
环境变量
本地配置文件（blog.config.js / conf/*.config.js）

推荐实践

将大块配置拆分到 conf/*.config.js
blog.config.js 仅做聚合，避免文件无限膨胀
新增配置项时，写清楚：
- 默认值
- 环境变量名
- Notion Config 同名键

开源协作高风险点（必须遵守）

1) 不要提交个性化配置

以下内容通常属于个人环境，不应提交：

.env.local
带私人 key/token 的配置
带个人广告 ID、统计 ID、第三方埋点 ID 的默认值
仅个人站点使用的导航/菜单/主题私有配置

2) 避免修改与任务无关的配置文件

例如你只修复一个组件 bug，不应顺手改动大量 conf/*.config.js 排序或格式。

3) 新增全局配置时要文档化

至少更新：

conf/*.config.js 注释
本目录文档或 PR 描述中的使用说明