文件名自定义

默认情况下,TinaCMS 不对文件名施加严格的限制,因为操作系统支持多种格式。然而,如果需要,您可以在集合级别施加自定义限制。

文件名规则

  • 文件名只能包含 a-zA-Z0-9-_./
  • 文件名不能包含空格
  • 生成的文件名在集合中必须是唯一的
  • 如果文件名以 / 开头,它将被视为相对于集合根目录的绝对路径
    • 示例:/foo/bar/blog-post 将被保存为 <MyCollectionPath>/post/blog-post.md
  • 如果文件名不以 / 开头,它将被视为相对于当前文件夹
    • 示例:bar/blog-post 将被保存为 <MyCollectionPath>/<CurrentDirectory>/bar/blog-post.md

配置

属性

描述

ui.filename.readonly

阻止用户编辑文件名

ui.filename.slugify

一个基于表单值生成文件名的函数

ui.filename.parse

一个在用户输入时清理文件名输入的函数

选项A:使用 parse 清理输入

parse 函数允许您在编辑器中施加文件名限制。提供的回调函数实时清理用户输入。

使用 parse 强制执行蛇形命名法的示例

选项B:使用 slugify 生成文件名

使用 slugify 函数根据集合中的其他字段自动生成文件名。

slugify 函数仅在用户创建新文件时施加限制。用户在创建后仍然可以自由重命名文件。

使用 slugify 和只读的示例

使用默认 slugify 的示例

如果没有提供 slugify 函数并且某个字段具有 isTitle: true,TinaCMS 将使用默认的 slugify 函数。这将移除非字母数字字符并将空格替换为短划线。

Last Edited: February 4, 2026