微信小程序 + Taro + i18next 原生 TabBar 多语言踩坑实录

0 阅读2分钟

页面文案接入 react-i18next 后,切换语言可以触发 React 更新。微信原生 TabBar 来自应用配置,还需要通过平台接口更新文字。

页面已经切成英文,原生 TabBar 仍显示中文

点击切换语言,页面文字发生变化,底部导航却保留原来的中文。只调用 changeLanguage 时,i18next 更新了订阅它的 React 组件,没有修改原生导航项。

src/app.config.ts 静态声明两个导航项:

export default defineAppConfig({
  pages: ['pages/dashboard', 'pages/devices'],
  tabBar: {
    list: [
      { pagePath: 'pages/dashboard', text: '主页' },
      { pagePath: 'pages/devices', text: '设备' },
    ],
  },
});

页面只负责切换 i18next 语言:

import { useTranslation } from 'react-i18next';
import { View } from '@tarojs/components';

export function LanguageSwitch() {
  const { t, i18n } = useTranslation();
  return (
    <View onClick={() => void i18n.changeLanguage('en-US')}>
      {t('action.save')}
    </View>
  );
}

这里假设英文资源已经存在。页面文案能变化,不代表编译后交给小程序读取的 app.config.ts 会重新执行。原生 TabBar 不属于 I18nextProvider 的 React 子树,需要 setTabBarItem 更新。

保留静态默认文字,再把语言事件同步到平台接口。src/i18n.ts 中的资源和初始化如下:

import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';

void i18n.use(initReactI18next).init({
  lng: 'zh-CN',
  fallbackLng: 'zh-CN',
  resources: {
    'zh-CN': { translation: {
      action: { save: '保存' },
      mini: { tabs: { home: '主页', devices: '设备' } },
    } },
    'en-US': { translation: {
      action: { save: 'Save' },
      mini: { tabs: { home: 'Home', devices: 'Devices' } },
    } },
  },
});

export { i18n };

在 src/app.tsx 注册更新逻辑,@ 表示已配置到 src 的别名,未配置时使用相应相对路径:

import { useEffect, type PropsWithChildren } from 'react';
import Taro from '@tarojs/taro';
import { i18n } from '@/i18n';

const tabBarValues = ['home', 'devices'] as const;

function refreshTabBar() {
  tabBarValues.forEach((value, index) => {
    void Taro.setTabBarItem({
      index,
      text: i18n.t(`mini.tabs.${value}`),
    });
  });
}

export default function App({ children }: PropsWithChildren) {
  useEffect(() => {
    refreshTabBar();
    i18n.on('languageChanged', refreshTabBar);
    return () => i18n.off('languageChanged', refreshTabBar);
  }, []);

  return children;
}

首次调用同步当前语言,languageChanged 处理后续切换,清理时移除同一个回调。翻译资源和监听逻辑缺一项,都可能使导航文字保留旧值。

数组顺序与 tabBar.list 对应。home 可以映射到 dashboard 页面,翻译 key 不必等于文件名,但 index 必须对应正确导航项。

重新编译后,在原生 TabBar 可见的页面检查首次进入和连续切换。若 API 调用时导航尚不可用,应根据失败结果调整同步时机;注册监听不等于平台调用一定成功。

页面内的 TDesign t-tab-bar 等组件与原生导航使用不同渲染路径,组件文字更新正常,不能代替对原生 TabBar 的检查。