内容扩展自定义

内容文件扩展名

Intlayer 允许您自定义内容声明文件的扩展名。这种自定义为管理大型项目提供了灵活性，并有助于避免与其他模块的冲突。

默认扩展名

默认情况下，Intlayer 会监视所有具有以下扩展名的文件作为内容声明：

• .content.json
• .content.ts
• .content.tsx
• .content.js
• .content.jsx
• .content.mjs
• .content.mjx
• .content.cjs
• .content.cjx

这些默认扩展名适用于大多数应用程序。然而，当您有特定需求时，可以定义自定义扩展名，以简化构建过程并降低与其他组件冲突的风险。

自定义内容扩展名

要自定义 Intlayer 用于识别内容声明文件的文件扩展名，您可以在 Intlayer 配置文件中指定它们。这种方法对于大型项目非常有用，因为限制监视范围可以提升构建性能。

以下是如何在配置中定义自定义内容扩展名的示例：

import type { IntlayerConfig } from "intlayer";const config: IntlayerConfig = {  content: {    fileExtensions: [".my_content.ts", ".my_content.tsx"], // 您的自定义扩展名  },};export default config;

在此示例中，配置指定了两个自定义扩展名：.my_content.ts 和 .my_content.tsx。Intlayer 只会监视具有这些扩展名的文件来构建字典。

自定义扩展名的好处

• 构建性能：减少监视文件的范围可以显著提升大型项目的构建性能。
• 避免冲突：自定义扩展名有助于防止与项目中的其他 JavaScript 或 TypeScript 文件发生冲突。
• 组织管理：自定义扩展名允许您根据项目需求组织内容声明文件。

自定义扩展名的指南

在自定义内容文件扩展名时，请牢记以下指南：

• 唯一性：选择在项目中唯一的扩展名以避免冲突。
• 命名一致性：使用一致的命名规范以提高代码的可读性和维护性。
• 避免常见扩展名：避免使用诸如 .ts 或 .js 等常见扩展名，以防与其他模块或库发生冲突。

结论

• 冲突避免：自定义扩展名有助于防止与项目中其他 JavaScript 或 TypeScript 文件发生冲突。
• 组织管理：自定义扩展名允许你根据项目需求组织内容声明文件。

自定义扩展名指南

在自定义内容文件扩展名时，请注意以下指南：

• 唯一性：选择在项目中唯一的扩展名以避免冲突。
• 命名一致性：使用一致的命名规范以提升代码可读性和维护性。
• 避免常用扩展名：避免使用如 .ts 或 .js 等常见扩展名，以防与其他模块或库冲突。

结论

在 Intlayer 中自定义内容文件扩展名是优化性能和避免大型应用中冲突的宝贵功能。通过遵循本档案中列出的指南，你可以有效管理内容声明，并确保与项目其他部分的顺利集成。

文档历史

• 5.5.10 - 2025-06-29：初始化历史