AiI18nLocaleLoadingOptions#

从 @ai-i18n/vite 导入：

import type { AiI18nLocaleLoadingOptions } from '@ai-i18n/vite';

#定义

interface AiI18nLocaleLoadingOptions {
  preload?: readonly string[];
  prefetch?: readonly string[];
}

#字段

#行为

顶层 loading 接受布尔值或本配置对象。省略或 false 保持全语言注册；true 使用默认 分包策略，对象可定制资源提示。开启后每个目标 locale 生成独立 Vite chunk，未提前加载的语言 在首次 setLang() 时加载。空对象同样使用默认分包策略。

列表必须满足以下约束：

• 只能引用 locales 中的目标 locale；
• 不能包含 sourceLang；
• 同一 locale 不能同时出现在两个列表中；
• 单个列表中的重复值会自动去重。

非 source 的 defaultLang 会自动加入 preload，因此不能再把它列入 prefetch；该组合会在启动时 报错。相同 locale 的并发调用复用底层加载请求；不同 locale 的并发切换以最后一次 setLang() 调用为准。

#示例

aiI18n({
  sourceLang: 'zh-CN',
  defaultLang: 'en-US',
  locales,
  loading: {
    preload: ['en-US'],
    prefetch: ['ja-JP'],
  },
});

完整使用流程见语言分包与按需加载。