国际化特性配置
i18n-mage.i18nFeatures.framework
- 类型:
enum - 默认值:
auto
选择使用的国际化框架:如 vue-i18n、react-i18next 等。支持以下选项:
auto: 自动检测项目使用的国际化框架vue-i18n: 使用vue-i18n框架react-i18next: 使用react-i18next框架i18next: 使用i18next框架(目前选择该项与react-i18next效果相同)vscode-l10n: 使用vscode-l10n框架none: 不使用框架
i18n-mage.i18nFeatures.translationFunctionNames
- 类型:
array - 默认值:
['t']
指定国际化转换函数名称列表,默认为 t。当框架为 vue-i18n 时,会强制启用 t 和 tc。
i18n-mage.i18nFeatures.namespaceStrategy
- 类型:
enum - 默认值:
auto
控制翻译键命名空间的生成策略,支持以下选项:
'auto'(自动推断):- 自动选择词条使用率不为 0 的命名空间策略
'full'(完整路径):- 使用语言文件的完整相对路径作为命名空间前缀
- 路径分隔符(如
/)会被替换为点号(.) - 示例:文件
zh/modules/components.json会生成前缀modules.components - 适合复杂项目结构,确保键的唯一性
'file'(仅文件名):- 仅使用文件名(不含扩展名)作为命名空间前缀
- 示例:文件
zh/modules/components.json会生成前缀components - 适合简单项目结构,键较短但可能不够唯一
'none'(无命名空间):- 不使用任何命名空间前缀,直接将语言文件内容合并到顶层
- 示例:文件
zh/modules/components.json中的键直接使用,不加前缀 - 需要确保所有语言文件中的键全局唯一,否则会发生覆盖
i18n-mage.i18nFeatures.interpolationBrackets
- 类型:
enum - 默认值:
auto
设置变量插值使用的花括号风格,默认跟随所选国际化框架(如 vue-i18n 用单花括号,react-i18next 用双花括号),支持以下选项:
auto: 跟随所选国际化框架默认行为single: 使用单花括号语法double: 使用双花括号语法
i18n-mage.i18nFeatures.namespaceSeparator
- 类型:
enum - 默认值:
auto
设置国际化命名空间分隔符,默认跟随所选国际化框架(如 vue-i18n 用.,react-i18next 用: ),支持以下选项:
auto: 跟随所选国际化框架默认行为.: 使用.分隔符:: 使用:分隔符
i18n-mage.i18nFeatures.defaultNamespace
- 类型:
string - 默认值:
translation
指定默认命名空间,用于简化像 react-i18next 和 i18next 等框架中的 t 函数调用。若未显式指定命名空间,系统将默认使用此命名空间。请确保该命名空间已正确加载。
