setLang()#

从 virtual:ai-i18n 导入：

import { setLang } from 'virtual:ai-i18n';

#签名

function setLang(value: string): Promise<void>;

#参数

value 必须匹配 AiI18nOptions.locales 中的某个 value。不支持的值会抛出 RangeError。

#行为

没有启用语言分包时，Runtime 会立即提交切换。启用 loading 后，Runtime 先加载目标语言 chunk，再切换语言并通知订阅者。

相同 locale 的并发调用会复用同一次底层语言包加载请求，但不保证各次 setLang() 返回的 Promise 引用相等。不同 locale 的并发切换以最后一次调用为准。 加载失败时 Promise 会 reject，当前语言保持不变，并通过 getLangLoadState() 暴露 error 快照。 共享状态不会消费 rejected Promise；即使 UI 只读取内置 error 状态，调用方仍需 await + catch 或显式 .catch()，避免 unhandled rejection。

配置 persist 后，切换成功的语言会写入 localStorage。

#示例

try {
  await setLang('en-US');
} catch {
  // 仅在需要业务级恢复动作时处理；通用 loading/error UI 可直接读取共享状态。
}

按需加载的完整示例见语言分包与按需加载。