i18next组件外使用时，是否支持类似useTranslation的keyPrefix/ns复用？

基础封装方案 #

i18next本身没有内置和useTranslation的keyPrefix完全对应的API，但你可以通过封装自定义翻译函数实现类似效果，同时解决TypeScript类型问题。

1. 封装带固定命名空间和前缀的t函数 #

假设你已经初始化了i18next实例，可创建工厂函数生成绑定指定namespace和keyPrefix的翻译函数：

import i18n from './your-i18n-config';
import type { TFunction } from 'i18next';

// 生成带前缀的翻译函数
function createPrefixedT(
  ns: string | string[],
  keyPrefix: string
): TFunction<typeof ns, typeof keyPrefix> {
  // 包装原始t函数，自动注入namespace和keyPrefix
  return (key, options) => {
    return i18n.t(`${keyPrefix}.${key}`, { ns, ...options });
  };
}

// 用法示例：封装用户模块的翻译函数
const userT = createPrefixedT('user', 'profile');
// 直接调用，无需重复写前缀和命名空间
userT('name'); // 等价于 i18n.t('profile.name', { ns: 'user' })
userT('age', { defaultValue: '年龄' });

2. 解决TypeScript键类型推断问题 #

上面的写法利用了i18next内置的TFunction泛型，会根据传入的ns和keyPrefix自动推断可使用的键类型。只要你的i18next项目配置了TypeScript类型支持（比如通过i18next-parser生成类型文件，或手动扩展翻译类型），封装后的函数会像useTranslation一样自动提示合法子键。

如果需要动态前缀，可调整工厂函数支持动态传入：

function createNsT(ns: string | string[]) {
  return (keyPrefix: string) => {
    return (key: string, options?: Parameters<TFunction>[1]) => {
      return i18n.t(`${keyPrefix}.${key}`, { ns, ...options });
    } as TFunction<typeof ns, typeof keyPrefix>;
  };
}

// 用法
const userNsT = createNsT('user');
const profileT = userNsT('profile');
profileT('name'); // 类型提示正常
const settingsT = userNsT('settings');
settingsT('theme');

3. 全局复用的进阶方案 #

如果需要在多个非组件文件中复用同一套配置，可直接导出封装好的翻译函数：

// i18n-prefixed.ts
import i18n from './i18n';

export const authT = createPrefixedT('auth', 'login');
export const dashboardT = createPrefixedT('dashboard', 'stats');

在工具函数或API文件中直接导入使用：

// api/utils.ts
import { authT } from '../i18n-prefixed';

function showAuthError() {
  alert(authT('invalidCredentials'));
}

关键注意点 #

• 确保i18next项目配置了TypeScript类型支持，否则类型推断会失效。
• 若使用多命名空间，createPrefixedT的第一个参数可传入数组（如['user', 'common']），翻译函数会自动在多个命名空间中查找键。

内容的提问来源于stack exchange，提问作者ngtrthinh