\u5f88\u591a\u56e2\u961f\u5728\u9879\u76ee\u521d\u671f\u4e3a\u4e86\u8d76\u8fdb\u5ea6\uff0c\u76f4\u63a5\u628a\u4e2d\u6587\u6587\u6848\u786c\u7f16\u7801\u5728\u7ec4\u4ef6\u91cc\uff0c\u7b49\u5230\u9700\u8981\u652f\u6301\u591a\u8bed\u8a00\u65f6\u624d\u53d1\u73b0\uff1a\u6539\u9020\u6210\u672c\u5de8\u5927\u3001\u7ffb\u8bd1\u6587\u4ef6\u96be\u4ee5\u7ef4\u62a4\u3001\u52a8\u6001\u5185\u5bb9\u65e0\u6cd5\u5904\u7406\u3002\u66f4\u7cdf\u7cd5\u7684\u662f\uff0c\u5373\u4f7f\u5f15\u5165\u4e86 \u672c\u6587\u5c06\u5e26\u4f60\u4ece\u96f6\u642d\u5efa\u4e00\u5957\u5de5\u7a0b\u5316\u3001\u53ef\u6269\u5c55\u3001\u9ad8\u6027\u80fd<\/strong>\u7684\u524d\u7aef\u56fd\u9645\u5316\u65b9\u6848\u3002\u6211\u4eec\u4ee5 React + i18next \u4e3a\u4f8b\uff0c\u4f46\u6838\u5fc3\u601d\u60f3\u540c\u6837\u9002\u7528\u4e8e Vue\u3001Svelte \u7b49\u6846\u67b6\u3002<\/p>\n \u521b\u5efa \u5728 \ud83d\udca1 \u6ce8\u610f<\/strong>\uff1a \u6309\u9875\u9762\u6216\u529f\u80fd\u6a21\u5757\u5212\u5206\u547d\u540d\u7a7a\u95f4\uff0c\u907f\u514d\u5355\u4e2a\u6587\u4ef6\u8fc7\u5927\uff1a<\/p>\n \u793a\u4f8b \ud83d\udca1 \u6ce8\u610f<\/strong>\uff1a\u590d\u6570\u5f62\u5f0f\u5728\u82f1\u6587\u4e2d\u9700\u8981\u533a\u5206 \u5bf9\u4e8e\u82f1\u6587\uff0c \u5982\u679c\u67d0\u4e2a\u9875\u9762\u53ea\u5728\u7279\u5b9a\u8def\u7531\u4e0b\u4f7f\u7528\uff0c\u53ef\u4ee5\u6309\u9700\u52a0\u8f7d\uff1a<\/p>\n \u6216\u8005\u5728\u7ec4\u4ef6\u6302\u8f7d\u65f6\u52a0\u8f7d\uff1a<\/p>\n \u624b\u52a8\u63d0\u53d6\u5bb9\u6613\u9057\u6f0f\uff0c\u63a8\u8350\u4f7f\u7528 \u914d\u7f6e \u5728 \u8fd0\u884c \u4f7f\u7528 \u7ec4\u4ef6\u4e2d\u4f7f\u7528\uff1a<\/p>\n \u7ffb\u8bd1\u6587\u4ef6\uff1a<\/p>\n \u5207\u6362\u8bed\u8a00\u65f6\uff0c\u5982\u679c\u7ffb\u8bd1\u6587\u4ef6\u672a\u52a0\u8f7d\u5b8c\u6210\uff0c\u9875\u9762\u4f1a\u663e\u793a key \u800c\u4e0d\u662f\u6587\u6848\u3002\u89e3\u51b3\u65b9\u6848\uff1a<\/p>\n \u6709\u65f6\u7ffb\u8bd1\u9700\u8981\u5305\u542b\u94fe\u63a5\u6216\u52a0\u7c97\u6587\u672c\uff0c\u4f7f\u7528 \u7ffb\u8bd1\u6587\u4ef6\uff1a<\/p>\n \ud83d\udca1 \u6ce8\u610f<\/strong>\uff1a \u63a8\u8350\u4f7f\u7528 Locize<\/a> \u6216 Crowdin<\/a> \u7ba1\u7406\u7ffb\u8bd1\u6d41\u7a0b\u3002\u901a\u8fc7 CLI \u5de5\u5177\u540c\u6b65\u7ffb\u8bd1\u6587\u4ef6\uff1a<\/p>\n \u524d\u7aef\u56fd\u9645\u5316\u4e0d\u662f\u7b80\u5355\u7684\u66ff\u6362\u6587\u6848\uff0c\u800c\u662f\u4e00\u5957\u9700\u8981\u4ece\u9879\u76ee\u521d\u671f\u5c31\u89c4\u5212\u597d\u7684\u5de5\u7a0b\u4f53\u7cfb\u3002\u672c\u6587\u4ecb\u7ecd\u7684\u65b9\u6848\u5df2\u5728\u591a\u4e2a\u4e2d\u5927\u578b\u9879\u76ee\u4e2d\u9a8c\u8bc1\uff0c\u6838\u5fc3\u8981\u70b9\uff1a<\/p>\n \u4e0b\u4e00\u6b65\uff0c\u4f60\u53ef\u4ee5\u63a2\u7d22\uff1a<\/p>\n \u5e0c\u671b\u8fd9\u7bc7\u6587\u7ae0\u80fd\u5e2e\u52a9\u4f60\u6253\u9020\u4e00\u4e2a\u4f18\u96c5\u3001\u53ef\u7ef4\u62a4\u7684\u56fd\u9645\u5316\u65b9\u6848\u3002<\/p>\n","protected":false},"excerpt":{"rendered":" \u672c\u6587\u5206\u4eab\u4e00\u5957\u7ecf\u8fc7\u5927\u578b\u9879\u76ee\u9a8c\u8bc1\u7684\u524d\u7aef\u56fd\u9645\u5316\u65b9\u6848\uff0c\u6db5\u76d6\u6587\u6848\u63d0\u53d6\u3001\u52a8\u6001\u52a0\u8f7d\u3001\u590d\u6570\u5904\u7406\u3001\u65e5\u671f\u683c\u5f0f\u5316\u7b49\u6838\u5fc3\u73af\u8282\uff0c\u5e76\u7ed9\u51fa\u53ef\u590d\u7528\u7684\u5de5\u7a0b\u5316\u914d\u7f6e\uff0c\u5e2e\u52a9\u4f60\u5f7b\u5e95\u544a\u522b\u786c\u7f16\u7801\u6587\u6848\u7684\u70e6\u607c\u3002<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3,4],"tags":[77,79,11,167,78],"class_list":["post-254","post","type-post","status-publish","format-standard","hentry","category-3","category-4","tag-i18n","tag-i18next","tag-react","tag-167","tag-78"],"_links":{"self":[{"href":"https:\/\/yykcj.com\/index.php?rest_route=\/wp\/v2\/posts\/254","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/yykcj.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/yykcj.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/yykcj.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/yykcj.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=254"}],"version-history":[{"count":0,"href":"https:\/\/yykcj.com\/index.php?rest_route=\/wp\/v2\/posts\/254\/revisions"}],"wp:attachment":[{"href":"https:\/\/yykcj.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=254"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/yykcj.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=254"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/yykcj.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=254"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}i18next<\/code> \u6216 react-intl<\/code>\uff0c\u4e5f\u5e38\u5e38\u56e0\u4e3a\u914d\u7f6e\u4e0d\u5f53\u5bfc\u81f4\u5305\u4f53\u79ef\u81a8\u80c0\u3001\u5207\u6362\u8bed\u8a00\u65f6\u9875\u9762\u95ea\u70c1\u3002<\/p>\n\u7b2c\u4e00\u6b65\uff1a\u9009\u578b\u4e0e\u57fa\u7840\u914d\u7f6e<\/h2>\n
1.1 \u4e3a\u4ec0\u4e48\u9009\u62e9 i18next\uff1f<\/h3>\n
\n
1.2 \u6700\u5c0f\u5316\u5b89\u88c5<\/h3>\n
\nnpm install i18next react-i18next i18next-browser-languagedetector i18next-http-backend\n<\/code><\/pre>\n1.3 \u521d\u59cb\u5316\u914d\u7f6e<\/h3>\n
src\/i18n.js<\/code>\uff1a<\/p>\n\nimport i18n from 'i18next';\nimport { initReactI18next } from 'react-i18next';\nimport LanguageDetector from 'i18next-browser-languagedetector';\nimport HttpBackend from 'i18next-http-backend';\n\ni18n\n .use(HttpBackend) \/\/ \u4ece\u670d\u52a1\u5668\u52a0\u8f7d\u7ffb\u8bd1\u6587\u4ef6\n .use(LanguageDetector) \/\/ \u81ea\u52a8\u68c0\u6d4b\u7528\u6237\u8bed\u8a00\n .use(initReactI18next)\n .init({\n fallbackLng: 'zh-CN', \/\/ \u9ed8\u8ba4\u8bed\u8a00\n debug: process.env.NODE_ENV === 'development',\n interpolation: {\n escapeValue: false, \/\/ React \u5df2\u7ecf\u5904\u7406\u4e86 XSS\n },\n backend: {\n loadPath: '\/locales\/{{lng}}\/{{ns}}.json', \/\/ \u7ffb\u8bd1\u6587\u4ef6\u8def\u5f84\n },\n ns: ['common'], \/\/ \u9ed8\u8ba4\u547d\u540d\u7a7a\u95f4\n defaultNS: 'common',\n });\n\nexport default i18n;\n<\/code><\/pre>\nindex.js<\/code> \u4e2d\u5f15\u5165\uff1a<\/p>\n\nimport '.\/i18n';\n<\/code><\/pre>\nloadPath<\/code> \u4e2d\u7684 {{lng}}<\/code> \u548c {{ns}}<\/code> \u4f1a\u88ab\u81ea\u52a8\u66ff\u6362\u3002\u5efa\u8bae\u5c06\u7ffb\u8bd1\u6587\u4ef6\u653e\u5728 public\/locales<\/code> \u76ee\u5f55\u4e0b\uff0c\u8fd9\u6837\u53ef\u4ee5\u76f4\u63a5\u901a\u8fc7 HTTP \u8bbf\u95ee\u3002<\/p>\n\u7b2c\u4e8c\u6b65\uff1a\u7ec4\u7ec7\u7ffb\u8bd1\u6587\u4ef6<\/h2>\n
2.1 \u76ee\u5f55\u7ed3\u6784<\/h3>\n
\npublic\/\n locales\/\n zh-CN\/\n common.json\n home.json\n en-US\/\n common.json\n home.json\n<\/code><\/pre>\n2.2 \u547d\u540d\u7a7a\u95f4\u5212\u5206<\/h3>\n
\n
common.json<\/code>\uff1a\u901a\u7528\u6587\u6848\uff08\u6309\u94ae\u3001\u63d0\u793a\u7b49\uff09<\/li>\nhome.json<\/code>\uff1a\u9996\u9875\u4e13\u7528<\/li>\nuser.json<\/code>\uff1a\u7528\u6237\u6a21\u5757<\/li>\n<\/ul>\ncommon.json<\/code><\/strong>\uff1a<\/p>\n\n{\n "welcome": "\u6b22\u8fce\u56de\u6765\uff0c{{name}}\uff01",\n "button": {\n "submit": "\u63d0\u4ea4",\n "cancel": "\u53d6\u6d88"\n },\n "items": "{{count}} \u4ef6\u5546\u54c1",\n "items_plural": "{{count}} \u4ef6\u5546\u54c1"\n}\n<\/code><\/pre>\n_plural<\/code>\uff0c\u4e2d\u6587\u867d\u7136\u4e0d\u9700\u8981\uff0c\u4f46\u4e3a\u4e86\u7edf\u4e00\u683c\u5f0f\uff0c\u5efa\u8bae\u4fdd\u7559\u3002<\/p>\n\u7b2c\u4e09\u6b65\uff1a\u5728\u7ec4\u4ef6\u4e2d\u4f7f\u7528<\/h2>\n
3.1 \u57fa\u672c\u7528\u6cd5<\/h3>\n
\nimport { useTranslation } from 'react-i18next';\n\nfunction App() {\n const { t, i18n } = useTranslation();\n\n const changeLanguage = (lng) => {\n i18n.changeLanguage(lng);\n };\n\n return (\n <div>\n <h1>{t('welcome', { name: '\u5f20\u4e09' })}<\/h1>\n <button onClick={() => changeLanguage('en-US')}>English<\/button>\n <button onClick={() => changeLanguage('zh-CN')}>\u4e2d\u6587<\/button>\n <\/div>\n );\n}\n<\/code><\/pre>\n3.2 \u5904\u7406\u590d\u6570<\/h3>\n
\n\/\/ \u6839\u636e count \u81ea\u52a8\u9009\u62e9\u5355\u590d\u6570\n<p>{t('items', { count: 3 })}<\/p>\n<\/code><\/pre>\ncommon.json<\/code> \u9700\u8981\u8fd9\u6837\u5199\uff1a<\/p>\n\n{\n "items": "{{count}} item",\n "items_plural": "{{count}} items"\n}\n<\/code><\/pre>\n3.3 \u52a8\u6001\u52a0\u8f7d\u547d\u540d\u7a7a\u95f4<\/h3>\n
\nconst { t } = useTranslation('home'); \/\/ \u52a0\u8f7d home \u547d\u540d\u7a7a\u95f4\n<\/code><\/pre>\n\nimport { useEffect } from 'react';\nimport { useTranslation } from 'react-i18next';\n\nfunction Home() {\n const { t, i18n } = useTranslation();\n\n useEffect(() => {\n i18n.loadNamespaces('home');\n }, [i18n]);\n\n return <h2>{t('home:title')}<\/h2>;\n}\n<\/code><\/pre>\n\u7b2c\u56db\u6b65\uff1a\u9ad8\u7ea7\u6280\u5de7\u4e0e\u6700\u4f73\u5b9e\u8df5<\/h2>\n
4.1 \u63d0\u53d6\u786c\u7f16\u7801\u6587\u6848<\/h3>\n
i18next-parser<\/code> \u81ea\u52a8\u626b\u63cf\u4ee3\u7801\u4e2d\u7684 t()<\/code> \u8c03\u7528\uff0c\u751f\u6210\u7ffb\u8bd1\u6587\u4ef6\u3002<\/p>\n\nnpm install i18next-parser --save-dev\n<\/code><\/pre>\ni18next-parser.config.js<\/code>\uff1a<\/p>\n\nmodule.exports = {\n locales: ['zh-CN', 'en-US'],\n output: 'public\/locales\/$LOCALE\/$NAMESPACE.json',\n input: ['src\/**\/*.{js,jsx,ts,tsx}'],\n sort: true,\n createOldCatalogs: false,\n};\n<\/code><\/pre>\npackage.json<\/code> \u4e2d\u6dfb\u52a0\u811a\u672c\uff1a<\/p>\n\n{\n "scripts": {\n "i18n:extract": "i18next-parser"\n }\n}\n<\/code><\/pre>\nnpm run i18n:extract<\/code>\uff0c\u5b83\u4f1a\u81ea\u52a8\u66f4\u65b0\u7ffb\u8bd1\u6587\u4ef6\uff0c\u4fdd\u7559\u5df2\u6709\u7ffb\u8bd1\u5e76\u6dfb\u52a0\u65b0 key\u3002<\/p>\n4.2 \u5904\u7406\u65e5\u671f\u3001\u65f6\u95f4\u548c\u8d27\u5e01<\/h3>\n
Intl<\/code> API \u914d\u5408 i18next \u7684\u683c\u5f0f\u5316\u529f\u80fd\uff1a<\/p>\n\n\/\/ \u5728 i18n.js \u4e2d\u914d\u7f6e\ninterpolation: {\n format: (value, format, lng) => {\n if (format === 'datetime') {\n return new Intl.DateTimeFormat(lng).format(value);\n }\n if (format === 'currency') {\n return new Intl.NumberFormat(lng, { style: 'currency', currency: 'USD' }).format(value);\n }\n return value;\n },\n},\n<\/code><\/pre>\n\n<p>{t('orderDate', { date: new Date(), format: 'datetime' })}<\/p>\n<\/code><\/pre>\n\n{\n "orderDate": "\u8ba2\u5355\u65e5\u671f\uff1a{{date, datetime}}"\n}\n<\/code><\/pre>\n4.3 \u907f\u514d\u8bed\u8a00\u5207\u6362\u95ea\u70c1<\/h3>\n
\n
\nbackend: {\n loadPath: '\/locales\/{{lng}}\/{{ns}}.json',\n \/\/ \u9884\u52a0\u8f7d\n allowMultiLoading: false,\n},\n<\/code><\/pre>\n\n
\nimport { Suspense } from 'react';\n\n<Suspense fallback={<div>Loading...<\/div>}>\n <App \/>\n<\/Suspense>\n<\/code><\/pre>\n\n
\nconst changeLanguage = async (lng) => {\n await i18n.loadLanguages(lng);\n i18n.changeLanguage(lng);\n};\n<\/code><\/pre>\n4.4 \u5904\u7406\u5e26 HTML \u7684\u7ffb\u8bd1<\/h3>\n
\nimport { Trans } from 'react-i18next';\n\n<Trans i18nKey="terms">\n \u8bf7\u9605\u8bfb <a href="\/terms">\u670d\u52a1\u6761\u6b3e<\/a>\n<\/Trans>\n<\/code><\/pre>\n\n{\n "terms": "\u8bf7\u9605\u8bfb <1>\u670d\u52a1\u6761\u6b3e<\/1>"\n}\n<\/code><\/pre>\n<1><\/code> \u5bf9\u5e94\u5b50\u5143\u7d20\u7d22\u5f15\uff0c\u4ece 0 \u5f00\u59cb\u3002<\/p>\n\u7b2c\u4e94\u6b65\uff1a\u5de5\u7a0b\u5316\u4e0e\u56e2\u961f\u534f\u4f5c<\/h2>\n
5.1 \u7ffb\u8bd1\u952e\u547d\u540d\u89c4\u8303<\/h3>\n
\n
userProfile.title<\/code><\/li>\nhome.hero.title<\/code><\/li>\ntext1<\/code>\u3001label2<\/code><\/li>\n<\/ul>\n5.2 \u4e0e\u7ffb\u8bd1\u5e73\u53f0\u96c6\u6210<\/h3>\n
\nnpm install locize-cli --save-dev\nnpx locize sync --project-id YOUR_PROJECT_ID --api-key YOUR_API_KEY\n<\/code><\/pre>\n5.3 \u6d4b\u8bd5\u4e0e\u6821\u9a8c<\/h3>\n
\n
i18next-parser<\/code> \u5e76\u68c0\u67e5\u662f\u5426\u6709\u672a\u7ffb\u8bd1\u7684 key<\/li>\n<\/ul>\n\n\/\/ \u7b80\u5355\u7684 key \u6821\u9a8c\u811a\u672c\nconst fs = require('fs');\nconst path = require('path');\n\nconst locales = ['zh-CN', 'en-US'];\nconst basePath = path.join(__dirname, 'public\/locales');\n\nlocales.forEach((lng) => {\n const files = fs.readdirSync(path.join(basePath, lng));\n files.forEach((file) => {\n const content = JSON.parse(fs.readFileSync(path.join(basePath, lng, file)));\n \/\/ \u68c0\u67e5\u662f\u5426\u6709\u7a7a\u503c\n Object.entries(content).forEach(([key, value]) => {\n if (!value) console.warn(`[${lng}] ${file} \u4e2d\u7684 ${key} \u4e3a\u7a7a`);\n });\n });\n});\n<\/code><\/pre>\n\u5e38\u89c1\u5751\u4e0e\u89e3\u51b3\u65b9\u6848<\/h2>\n
\n
ns:key<\/code> \u660e\u786e\u6307\u5b9a\u3002<\/li>\nt(variable)<\/code>\uff0c\u8fd9\u4f1a\u5bfc\u81f4\u65e0\u6cd5\u9759\u6001\u63d0\u53d6\uff0c\u5efa\u8bae\u7528\u6620\u5c04\u8868\u3002<\/li>\ni18next-http-backend<\/code> \u6309\u9700\u52a0\u8f7d\uff0c\u5e76\u5f00\u542f HTTP \u7f13\u5b58\u3002<\/li>\n\u603b\u7ed3<\/h2>\n
\n
Intl<\/code> \u5904\u7406\u65e5\u671f\u3001\u8d27\u5e01\u7b49\u672c\u5730\u5316\u683c\u5f0f<\/li>\n\n
i18next-icu<\/code> \u652f\u6301\u66f4\u590d\u6742\u7684 ICU \u6d88\u606f\u683c\u5f0f<\/li>\n