自定义文件命名

下载的视频文件名经常乱七八糟——视频 ID、随机字符串，或者跟你实际想要的不一样的标题。Fetchii 让你可以设置一个命名模板，按你想要的方式给下载的文件命名。

模板系统

与其接受来源提供的任何文件名，你可以用变量定义一个模式，Fetchii 会自动填充。变量写在花括号里，比如 {title} 或 {uploader}，在保存文件时会被替换成实际值。

例如，模板 {uploader} - {title} 可能产生 科技评测 - 2026 最佳笔记本.mp4。每次下载都遵循你的模式，创建一致、有组织的文件。扩展名会自动加上。

设置命名模板

打开 Fetchii → 设置 → 下载，找到 文件名与文件夹 分组。下载命名模板 一栏就是你的模板，默认是 {title}_{resolution}。

编辑器会帮你拼出模板，不用死记变量：

• 预设——现成模板的菜单：标题、标题_分辨率、日期 标题、序号 标题
• 变量标签——在“点击加入文件名：”下面，点一个标签（比如“标题”或“上传日期”），它的变量就会加到模板末尾
• 示例——实时预览你的模板给一个示例视频生成的文件名

模板对之后的每个新下载生效，没有单次下载的命名选项；要给已有的文件改名，在它那一行右键选择 智能命名（见摘要与智能命名）。直播录制有自己的模板，在 设置 → 录制 → 命名 里。

可用变量

下面是 Fetchii 认识的全部变量：

基本信息

技术详情

播放列表信息

整体下载播放列表时，视频 ID、频道、上传日期、时长和播放次数用不了——设置页面在这一栏下方也会这样提示。

实用模板示例

来看看一些能解决实际整理问题的模板。

简单干净

{title}

只有视频标题。干净易读。如果你的下载内容很杂、不需要复杂整理，这就很好用。

结果：2026 最佳笔记本.mp4

包含画质

{title} [{resolution}]

当你下载同一视频的多个画质，或者只是想一眼看出每个文件的画质时。

结果：2026 最佳笔记本 [1080p].mp4

频道在前

{uploader} - {title}

同一频道的文件在访达里会排在一起。模板不能创建文件夹（见下文），所以这是把同一频道的视频放在一起的办法。

结果：科技评测 - 2026 最佳笔记本.mp4

按时间归档

{upload_date} {title}

适合想按日期排序的归档内容。YYYY-MM-DD 格式的日期在访达里能正确排序。

结果：2026-01-07 2026 最佳笔记本.mp4

播放列表集数

{playlist_index} {title}

播放列表序号至少是两位数（01、02……而不是 1、2……），所以各集能正确排序。

结果：05 西班牙语课 - 问候.mp4

完整归档模板

{upload_date} {uploader} - {title} [{resolution}]

一个文件名里放进最多的信息：日期、频道、标题和画质。适合大型归档，想快速找到任何东西。

结果：2026-01-07 科技评测 - 2026 最佳笔记本 [1080p].mp4

确保唯一性

{title} [{id}]

加上视频 ID 能保证唯一性，即使两个视频标题完全相同。如果你从可能有重复标题的来源下载，这很重要。

结果：2026 最佳笔记本 [abc123xyz].mp4

文件夹与缺失的值

播放列表文件夹

模板不能创建子文件夹。想让播放列表的视频放在一起，就打开同一分组里的 创建播放列表文件夹（默认已打开）。下载播放列表时，Fetchii 会创建一个以播放列表命名的子文件夹。

缺失的值

不是每个视频都有全部元数据。如果某个变量没有值，Fetchii 会把它连同旁边的分隔符一起去掉，所以文件名里永远不会出现字面的 {uploader} 或多余的 _。如果整个模板最后变成空的，就使用视频标题。

编辑器会提示什么

编辑器会在你输入时检查模板：

• 不认识的变量——花括号里 Fetchii 不认识的内容（包括 yt-dlp 风格的 %(title)s 字段）会被列为“不认识的变量，会原样写进文件名”
• 斜杠和冒号——/ 和 : 会被替换成 _，文件名不能用来建子文件夹
• 空模板——会使用视频标题

Fetchii 如何处理特殊字符

操作系统不允许文件名中出现某些字符。Fetchii 会自动把有问题的字符替换成下划线（_）：

• 斜杠（/ 和 \）
• 冒号（:）
• 星号（*）
• 问号（?）
• 引号（"）
• 尖括号（< 和 >）
• 竖线（|）

这同时适用于你的模板和标题之类的值。Fetchii 还会去掉看不见的控制字符，并让每个文件名都不超过 macOS 允许的 255 字节。

你不用担心文件名无效——Fetchii 会自动处理。

好模板的技巧

保持简单。 像 {title} 或 {uploader} - {title} 这样的模板对大多数人就够了。除非真的需要，别加复杂度。

加上 ID 确保唯一。 如果你在建一个大型归档，{title} [{id}] 能在不同视频标题相同时避免命名冲突。

先看示例。 这一栏下方的“示例”会在你开始批量下载之前，准确显示文件名会是什么样。

考虑文件名长度。 标题很长，文件名就很长。超过 macOS 限制的文件名 Fetchii 会自动截短，但模板短一些用起来更方便。

归档时用日期。 如果你在建长期归档，加上 {upload_date} 能方便地看出内容最初是什么时候发布的。

故障排除

变量原样显示（没被替换）：编辑器会把它们列为“不认识的变量，会原样写进文件名”。对照上面的表检查拼写——变量都是小写——或者直接点标签添加，不要手打。

文件名缺了一部分：这个视频没有那项元数据，或者你是整体下载播放列表，有些变量用不了。用总是存在的变量，比如 {title}。

想要文件夹却得到了下划线：模板不能创建文件夹。播放列表请用 创建播放列表文件夹，或者把你想按它分组的信息放在文件名开头。