Pages CMS中动态文件名配置的正确使用方式

在使用Pages CMS进行内容管理时，配置集合(collection)的文件名生成规则是一个常见需求。很多开发者会遇到文件名被直接保存为字面值的问题，比如fields.title.mdx这样的非预期结果。

问题现象

当在Pages CMS配置文件中尝试使用动态字段作为文件名时，比如：

filename: fields.title.mdx

系统会直接将整个字符串fields.title.mdx作为文件名保存，而不是解析其中的字段值。

解决方案

正确的做法是使用花括号{}包裹字段名，形成模板字符串：

filename: "{fields.title}.mdx"

这种语法告诉Pages CMS这是一个需要解析的动态字段，而不是字面字符串。系统会在创建文件时自动将fields.title替换为实际的内容标题值。

技术原理

Pages CMS的文件名配置遵循模板字符串的解析规则：

1. 花括号{}内的内容会被识别为需要解析的变量
2. 支持多种变量类型：
   • fields.字段名：引用集合中定义的字段值
   • primary：引用主键字段值
   • 日期格式等特殊变量

最佳实践建议

1. 对于简单的标题字段，推荐使用：

   filename: "{fields.title}.mdx"
   

2. 如果需要包含日期信息，可以组合使用：

   filename: "{fields.date}-{fields.title}.mdx"
   

3. 确保引用的字段在集合配置中已正确定义且必填

4. 对于复杂场景，可以考虑使用JavaScript函数进行更灵活的文件名生成

常见误区

1. 忘记添加花括号，导致字段名被当作字面字符串
2. 引用了未定义的字段
3. 字段值包含特殊字符导致文件系统问题
4. 在多语言环境下未考虑字符编码问题