@weapp-vite/i18n

一方维护的微信小程序 i18n 运行时与编译器。它不依赖 Vite、Vue、Wevu、Intlify、i18next 或 messageformat，可以直接用于原生微信小程序。

原生小程序

安装运行时并生成 locale catalog：

pnpm add @weapp-vite/i18n
pnpm exec weapp-i18n compile \
  --src-root miniprogram \
  --default-locale zh-CN \
  --fallback-locale en-US

命令扫描 <src-root>/**/i18n/*.json，生成 <src-root>/i18n/locales.js 与 locales.wxs。在项目工具中执行“构建 npm”后，创建应用内实例：

const { createI18n } = require('@weapp-vite/i18n')
const catalog = require('./i18n/locales')

// locales.js 是 compile 命令生成的预编译 catalog
const i18n = createI18n(catalog)

module.exports = i18n

Component 和使用 Component 构造的 Page 直接接入 Behavior：

const { i18n } = require('../../i18n')

Component({
  behaviors: [i18n.behavior],
})

传统 Page({...}) 使用显式适配器：

const { i18n } = require('../../i18n')

i18n.page({
  data: {},
})

WXML 显式引用生成的 WXS：

<wxs module="i18n" src="/i18n/locales.wxs" />
<view>{{ i18n.t(__wv_i18n_locale, 'greeting', { user }) }}</view>

本包不提供 @miniprogram-i18n/core 的 singleton 兼容入口。迁移时请把词典转换为普通 locale -> key -> string 消息对象，并为每个小程序运行时显式创建一个 createI18n() 实例；旧包的 select/ICU 消息需要按 v1 占位符语义调整。

实例通过 i18n.global.t()、i18n.global.locale 和 i18n.global.onLocaleChange() 访问运行时状态；不自动读写 storage，也不修改宿主的 Page/Component 构造器。

weapp-vite

使用 weapp.i18n 时继续从 weapp-vite/i18n 导入当前构建实例。weapp-vite 负责扫描、WXML 改写、分包资产归属、Vite/Rolldown emit 和 HMR；实际运行时与消息编译语义由本包提供。

v1 支持纯文本、fallback、{name} 和 {user.name} 插值。暂不支持 ICU、plural、select、日期、数字或货币格式化。