React 快速入門
使用 yarn 安裝 glotstack
yarn install glotstack
在你的 React 應用中添加 glotstack 提供者
import * as React from 'react'
import { GlotstackProvider } from 'glotstack'

const importMethod = (locale: string) => {
  // 使用 fetch() 從靜態目錄拉取,以限制包的大小,並將翻譯檔案儲存在靜態路徑
  return fetch(`/public/translations/${locale}.json`)
}
// // 或者使用行內 require 來獲取內建翻譯——這在不支持動態導入的環境中有效
const translations: Record<string, () => Promise<Translations>> = {
  'en-US': () => require('@/translations/en-US.json'),
  'pl-PL': () => require('@/translations/pl-PL.json'),
  'fr-FR': () => require('@/translations/fr-FR.json'),
};

const importMethod2 = (locale: string) => {
  return translations[locale]();
}

const Application = () => {
  const locale = 'en-US' // replace with your locale source
  return (
    <GlotstackProvider initialLocale={locale} importMethod={importMethod}>
      {/*<YourComponent />*/}
    </GlotstackProvider>
  )
}
何時使用 fetch 或 import?
fetch() 會從任何靜態託管的文件中拉取檔案,例如 CDN,這有助於保持包的大小較小,尤其是在 Cloudflare Workers 等環境中有大小限制的情況下。除非你的環境無法支持動態導入語法,否則 fetch() 幾乎總是更好的選擇。 對於小型應用或 react-native,我們建議使用 require() 將資產打包到你的託管包中。
useGlotstack() 在你的組件中使用
import * as React from 'react'
import {useGlotstack} from 'glotstack'

function MyComponent() => {
  const {t} = useGlotstack()

  return (
    <div>
      {t('Quickstart.example', {assigns: {userName: 'JD'}})}
      {/* Icon can be a function reference or a node */}
      {t('Quickstart.example2', {assigns: {Icon: <Icon/>}})}
    </div>
  )
}
創建你的翻譯源文件
你可以使用你的母語,但 Glotstack 默認使用 en-US.json 。我們建議將其放置在 ./translations/en-US.json 這樣的位置。如果擔心包的大小,可以通過使用公共檔案如 ./public/translations/en-US.json 來降低包的大小
全新
不喜歡編輯 JSON?
試試用 YAML 寫你的翻譯檔(我們也是這樣做的!) 用 YAML 進行多語言化
獲取翻譯
選項 1
: 在你的項目中創建 .glotstack.json
你可以使用配置中提供的 API 金鑰。你可以進行 10 次翻譯,然後需要註冊。
執行 get-translations
yarn glotstack get-translations
即將推出!透過 yarn glotstack live-translate 實時翻譯
選項 2:
使用 CLI 拉取翻譯
export GLOTSTACK_API_KEY="Drl85MXtxgWsYq0PfWiSFAeFkCJRKpfe40pPoGKcyZ0D5HwfXwsk+xFq72uCGhvEnVV1rZdBUansecB3J+r5XA==" 
yarn glotstack get-translations --source-path "./translations" --project-id "first-project" pl-PL fr-FR
使用終端機是可以的!但我們的選項可能會經常變化,這樣我們更新配置會更方便,而不需要你去更新保存的指令。
© 2026 Glotstack.ai。版權所有。
Glotstack 是為 React 打造的開發者優先多語言化工作流程: 管理 YAML/JSON 中的翻譯,保持語言同步,並用 AI 輔助工具更快推出新語言