小程序国际化与多语言支持

// 获取系统语言与地区
function detectLocale() {
  const baseInfo = wx.getAppBaseInfo();
  const systemInfo = wx.getSystemInfoSync();

  const lang = baseInfo.language || 'zh_CN';
  const region = systemInfo.country || 'CN';

  // 语言优先，地区补充
  return normalizeLocale(lang, region);
}

function normalizeLocale(lang, region) {
  const map = {
    'en': 'en-US',
    'zh_CN': 'zh-CN',
    'zh_TW': 'zh-TW',
    'zh_HK': 'zh-HK',
    'ja': 'ja-JP'
  };
  return map[lang] || map[region] || 'en-US';
}

{
  "common": {
    "confirm": "确认",
    "cancel": "取消",
    "loading": "加载中..."
  },
  "order": {
    "status_paid": "已支付",
    "status_shipped": "已发货",
    "total": "共 {count} 件商品"
  }
}

{
  "common": {
    "confirm": "Confirm",
    "cancel": "Cancel",
    "loading": "Loading..."
  },
  "order": {
    "status_paid": "Paid",
    "status_shipped": "Shipped",
    "total": "{count} items in total"
  }
}

// utils/i18n.js：轻量 i18n 实现
const locales = {
  'zh-CN': require('./locales/zh-CN.json'),
  'en-US': require('./locales/en-US.json')
};

let currentLocale = 'zh-CN';

function setLocale(locale) {
  currentLocale = locales[locale] ? locale : 'en-US';
  wx.setStorageSync('locale', currentLocale);
}

function t(key, params) {
  let text = currentLocale in locales
    ? lookup(locales[currentLocale], key)
    : key;
  // 占位符替换：{count} → 实际值
  if (params) {
    Object.keys(params).forEach((k) => {
      text = text.replace('{' + k + '}', String(params[k]));
    });
  }
  return text;
}

function lookup(obj, key) {
  return key.split('.').reduce((o, k) => (o && o[k]) || key, obj);
}

module.exports = { t, setLocale, getLocale: () => currentLocale };

// 按用户时区格式化日期
function formatDate(ts, locale) {
  const d = new Date(ts);
  const opts = { year: 'numeric', month: '2-digit', day: '2-digit' };
  return d.toLocaleDateString(locale, opts);
}

// 统一接口：服务端返回 UTC 毫秒时间戳
{
  "created_at": 1780200000000,
  "server_timezone": "UTC"
}

// 金额格式化：币种 + 千分位 + 小数位
function formatMoney(amount, currency, locale) {
  return new Intl.NumberFormat(locale, {
    style: 'currency',
    currency: currency
  }).format(amount / 100);   // 金额以「分」为单位存储
}

// 示例：formatMoney(123456, 'CNY', 'zh-CN') → ¥1,234.56
//      formatMoney(19900, 'USD', 'en-US') → $199.00

/* 针对 RTL 语言的样式适配 */
.page-rtl {
  direction: rtl;
  text-align: right;
}

// 根据语言设置 RTL 标记
function applyDirection(locale) {
  const rtlLangs = ['ar', 'he', 'fa'];
  const isRtl = rtlLangs.includes(locale.split('-')[0]);
  wx.setStorageSync('is_rtl', isRtl);
  if (isRtl) {
    wx.setNavigationBarTitle({ title: t('app.name') });
  }
}

运营修改文案
    ↓ 翻译平台完成多语言翻译
    ↓ 发布到云端文案服务（带版本号）
客户端启动拉取文案版本
    ↓ 有新版则增量更新本地文案
下次启动生效（或提示刷新）

// 检查工具：占位符一致性校验
function validatePlaceholders(keys, refLocale, targetLocales) {
  const refTexts = keys.map((k) => lookup(refLocale, k));
  targetLocales.forEach((locale) => {
    keys.forEach((k, i) => {
      const target = lookup(locale, k);
      // 占位符集合必须一致
      const refVars = refTexts[i].match(/\{[^}]+\}/g) || [];
      const tgtVars = (target.match(/\{[^}]+\}/g) || []);
      if (refVars.sort().join() !== tgtVars.sort().join()) {
        console.error('占位符不一致:', k, locale);
      }
    });
  });
}