告别混乱文件名！Zotero-Better-Notes自定义导出命名全攻略

你是否还在为导出的笔记文件命名混乱而烦恼？每次导出都要手动重命名？本文将详细介绍Zotero-Better-Notes中强大的导出文件命名规则，让你轻松实现文件名的个性化定制，提升文献管理效率。

命名规则基础：默认命名方式

Zotero-Better-Notes提供了灵活的文件命名机制，默认情况下，导出文件名将基于笔记标题生成。例如，当你导出一个标题为"人工智能发展简史"的笔记时，默认生成的文件名将是"人工智能发展简史.md"（Markdown格式）或"人工智能发展简史.docx"（Word格式）。

这一默认行为在src/modules/export/api.ts中定义，相关代码片段如下：

const raw = await new ztoolkit.FilePicker(
  `${Zotero.getString("fileInterface.export")} MS Word Docx`,
  "save",
  [["MS Word Docx File(*.docx)", "*.docx"]],
  `${noteItem.getNoteTitle()}.docx`,
).open();

自定义命名核心：getMDFileName方法

Zotero-Better-Notes的高级之处在于允许用户通过模板自定义导出文件名。这一功能的核心实现位于src/api.ts中的getMDFileName方法：

const sync = {
  // ...其他方法
  getMDFileName,
  // ...其他方法
};

该方法负责根据笔记ID和保存目录生成自定义文件名。通过结合模板系统，你可以实现包含日期、标签、作者等多种元数据的动态文件名。

同步场景下的命名规则

在启用同步功能时，文件名生成逻辑会略有不同。src/modules/export/markdown.ts中的syncMDBatch函数处理批量同步时的文件名生成：

for (const noteItem of noteItems) {
  const filename = await addon.api.sync.getMDFileName(noteItem.id, saveDir);
  const filePath = jointPath(saveDir, filename);
  // ...保存文件
}

同步模式下，系统会确保文件名的唯一性和一致性，避免因文件名冲突导致的同步问题。

命名模板配置：个性化你的文件名

要实现真正的自定义命名，需要使用Zotero-Better-Notes的模板系统。模板系统的核心定义在src/modules/template/api.ts中，通过runTemplate等方法支持复杂的命名规则：

export {
  runTemplate,
  runTextTemplate,
  runItemTemplate,
  runQuickInsertTemplate,
};

你可以创建包含动态变量的命名模板，例如：

• {{date:YYYY-MM-DD}}-{{title}}.md：生成包含日期和标题的文件名
• {{author}}-{{year}}-{{title}}.md：结合文献作者、年份和标题

多格式导出的命名一致性

无论你导出为Markdown、Word、LaTeX还是FreeMind格式，Zotero-Better-Notes都保持一致的命名逻辑。以LaTeX导出为例（src/modules/export/latex.ts）：

const raw = await new ztoolkit.FilePicker(
  `${Zotero.getString("fileInterface.export")} Latex File`,
  "save",
  [
    ["Latex File(*.tex)", "*.tex"],
    ["All Files", "*"],
  ],
  `${noteItem.getNoteTitle()}.tex`,
).open();

这种一致性确保你在切换导出格式时，文件名逻辑保持不变，减少学习成本。

命名冲突解决方案

当多个笔记可能生成相同文件名时，Zotero-Better-Notes会自动处理命名冲突。系统会在文件名后添加数字后缀（如"笔记.md"、"笔记-1.md"）来确保每个文件都有唯一的名称。这一机制在src/modules/sync/api.ts中实现，确保即使在复杂的同步场景下也不会出现文件名冲突。

通过掌握这些命名规则和自定义方法，你可以让Zotero-Better-Notes导出的文件更加有序、易管理，从而提升整个文献管理流程的效率。无论是个人知识管理还是学术写作，合理的文件命名习惯都将为你节省大量时间和精力。

官方文档中关于模板的更多信息：docs/about-note-template.md