python使用fastapi实现多语言国际化的操作指南

web/
├── locales/                # 语言资源目录
│   ├── zh/                 # 中文（简体）
│   ├── cht/                # 中文（繁体）
│   ├── en/                 # 英文
│   └── ...                 # 其他语言
├── scripts/
│   └── generate_po.py      # 翻译文件生成脚本
└── utils/
    └── baidutran.py        # 百度翻译工具
    └── chinesetw.py  # 中文转换工具

# 生成所有语言翻译
python generate_po.py

# 生成特定语言翻译
python generate_po.py en

<!-- 使用 _() 函数进行文本本地化 -->
<span>{{ _('用户名') }}</span>

@router.get("/change_language")
def change_language(request: Request, lang: str):
    # 设置语言 Cookie 或 Session
    request.session['lang'] = lang

<div class="info-item">
    <span class="info-label"> {{ _('账号类型') }} :</span>
    <span>
        {{ _('管理员') if user.is_admin else _('普通用户') }}
    </span>
</div>
<div class="info-item">
    <span class="info-label"> {{ _('性别') }} :</span>
    <span>
        {{ _('男') if user.sex == '1' else _('女') if user.sex == '0' else user.sex}}
    </span>
</div>

<form action="" method="">
    <div class="mb-3">
        <input type="hidden" name="id" id="id" value="0">
        <label for="content" class="form-label">{{ _('询价') }} </label>
        <textarea class="form-control" id="content" name="content" rows="3" required></textarea>
    </div>
    <button type="button" class="btn btn-primary">{{ _('提交') }} </button>
</form>

$(function(){
    $('.btn-primary').on('click', function(e) {
        $.ajax({
            url:'/addcomment',
            type: 'POST',
            data: form.serialize(),
            success: function(data) {
                if (data.status === 'success') {
                    location.reload();
                } else {
                    // 使用服务端传递的本地化错误消息
                    errorDiv.text(data.message);
                }
            }
        });
    });
});

def baidu_translate(query, from_lang='zh', to_lang='en'):
    """调用百度翻译API进行翻译"""
    # 安全检查：跳过特定类型的文本
    if re.match(r'^/?https?://.+\.(jpg|png|jpeg|gif|bmp|mp3|wav|ogg|mp4|avi|mov|wmv|flv|mkv)$', query):
        return query
    elif re.match(r'^\d{1,11}@[\w.-]{2,30}\.[\w.-]{2,10}$', query):
        return query
    
    # 生成百度翻译所需的签名
    salt = random.randint(32768, 65536)
    sign_str = f"{app_id}{query}{salt}{secret_key}"
    sign = hashlib.md5(sign_str.encode('utf-8')).hexdigest()
    
    # 调用翻译 API
    params = {
        'q': query,
        'from': from_lang,
        'to': to_lang,
        'appid': app_id,
        'salt': salt,
        'sign': sign
    }

# 中文翻译到英文
english_text = baidu_translate("国际婚姻网", from_lang='zh', to_lang='en')
# 结果: "International Marriage Network"

# 英文翻译到中文
chinese_text = baidu_translate("Hello World", from_lang='en', to_lang='zh')
# 结果: "你好，世界"

# 支持多种语言转换
japanese_text = baidu_translate("你好", from_lang='zh', to_lang='jp')
french_text = baidu_translate("Hello", from_lang='en', to_lang='fra')

error_map = {
    '52003': '未授权用户',
    '54000': '必填参数为空',
    '54001': '签名错误',
    '54003': '访问频率受限',
    '54004': '账户余额不足',
    '54005': '长query请求频繁',
    '58000': '客户端IP非法',
    '58001': '译文语言方向不支持'
}

# .env 文件配置
BAIDU_TRANS_APPID=your_app_id
BAIDU_TRANS_SECRET_KEY=your_secret_key
BAIDU_TRANS_HOST=https://fanyi-api.baidu.com/api/trans/vip/translate

class ChineseConverter:
    def __init__(self):
        self.s2t = OpenCC('s2t')  # 简体到繁体
        self.t2s = OpenCC('t2s')  # 繁体到简体

    def to_traditional(self, text: str) -> str:
        """将简体中文转换为繁体中文"""
        return self.s2t.convert(text)

    def to_simplified(self, text: str) -> str:
        """将繁体中文转换为简体中文"""
        return self.t2s.convert(text)

    def to_pinyin(self, text: str, style=Style.NORMAL) -> list:
        """
        将中文转换为拼音
        支持多种拼音样式
        """
        return pinyin(text, style=style)

    def to_pinyin_str(self, text: str, separator=' ', style=Style.NORMAL) -> str:
        """将中文转换为拼音字符串"""
        py_list = self.to_pinyin(text, style=style)
        return separator.join([''.join(p) for p in py_list])

converter.to_pinyin_str("国际婚姻网")
# 输出: guo ji hun yin wang

converter.to_pinyin_str("国际婚姻网", style=Style.TONE)
# 输出: guó jì hūn yìn wǎng

converter.to_pinyin_str("国际婚姻网", style=Style.TONE2)
# 输出: guo2 ji4 hun1 yin4 wang3

converter.to_pinyin_str("国际婚姻网", style=Style.FIRST_LETTER, separator='')
# 输出: gjhyw

# 简体转繁体
traditional_text = converter.to_traditional("国际婚姻网")
# 结果: 國際婚姻網

# 繁体转简体
simplified_text = converter.to_simplified("國際婚姻網")
# 结果: 国际婚姻网

# 获取带声调拼音
pinyin_with_tone = converter.to_pinyin_str("国际婚姻网", style=Style.TONE)
# 结果: guó jì hūn yìn wǎng

# 推荐创建全局转换器实例
converter = ChineseConverter()

class Translation(Base):
    __tablename__ = 'translations'
    
    # 主键
    id = Column(Integer, primary_key=True, autoincrement=True)
    
    # 原始文本标识符
    msgid = Column(String(255), nullable=False)
    
    # 翻译后的文本
    msgstr = Column(String(255), nullable=False)
    
    # 语言代码
    lang_code = Column(String(10), nullable=False)
    
    # 创建时间戳
    created_at = Column(DateTime, server_default=func.now())
    
    # 最后更新时间戳
    updated_at = Column(DateTime, server_default=func.now(), onupdate=func.now())

    # 唯一约束：确保每个 msgid 在特定语言中只有一个翻译
    __table_args__ = (
        UniqueConstraint('msgid', 'lang_code', name='unique_translation'),
    )

# 创建新翻译
new_translation = Translation(
    msgid='用户名',
    msgstr='Username',
    lang_code='en'
)
db.add(new_translation)
db.commit()

# 查询特定语言翻译
english_translations = db.query(Translation).filter_by(lang_code='en').all()

def generate_translations(output_dir='locales', specific_lang=None):
    """
    生成翻译文件
    
    Args:
        output_dir (str): 输出目录
        specific_lang (str, optional): 指定语言代码
    """
    # 获取中文（简体）基础翻译
    zh_translations = generator.get_translations('zh')
    
    # 确定要生成的语言
    if specific_lang:
        other_langs = [specific_lang]
    else:
        other_langs = generator.get_available_languages()

    # 为每种语言生成翻译文件
    for lang_code in other_langs:
        # 创建语言目录
        lang_dir = os.path.join(output_dir, lang_code, 'LC_MESSAGES')
        os.makedirs(lang_dir, exist_ok=True)
        
        # 生成 .po 文件
        with open(os.path.join(lang_dir, 'messages.po'), 'w') as f:
            # 写入文件头
            # 写入翻译条目
            for zh_trans in zh_translations:
                # 使用百度翻译 API 翻译
                msgstr = baidu_translate(zh_trans['msgid'], from_lang='zh', to_lang=lang_code)
                
                # 写入翻译条目
                f.write(f'msgid "{zh_trans["msgid"]}"\n')
                f.write(f'msgstr "{msgstr}"\n')

### 语言提示保存在表里

DROP TABLE IF EXISTS translations;
CREATE TABLE translations (
id int NOT NULL AUTO_INCREMENT,
msgid varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL,
msgstr varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL,
lang_code varchar(10) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL,
created_at timestamp NULL DEFAULT CURRENT_TIMESTAMP,
updated_at timestamp NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
PRIMARY KEY (id) USING BTREE,
UNIQUE INDEX unique_translation(msgid ASC, lang_code ASC) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 32 CHARACTER SET = utf8mb4 COLLATE = utf8mb4_general_ci ROW_FORMAT = Dynamic;

INSERT INTO translations VALUES (1, ‘首页', ‘首页', ‘zh', ‘2025-02-15 13:50:35', ‘2025-02-15 13:53:03');
INSERT INTO translations VALUES (2, ‘分类', ‘分类', ‘zh', ‘2025-02-15 13:50:35', ‘2025-02-15 13:53:03');
INSERT INTO translations VALUES (3, ‘标签', ‘标签', ‘zh', ‘2025-02-15 13:50:35', ‘2025-02-15 13:53:03');
INSERT INTO translations VALUES (4, ‘关于', ‘关于', ‘zh', ‘2025-02-15 13:50:35', ‘2025-02-15 13:53:03');
INSERT INTO translations VALUES (5, ‘个人资料', ‘个人资料', ‘zh', ‘2025-02-15 13:50:35', ‘2025-02-15 13:53:03');

#中文
msgid “邮件验证”
msgstr “邮件验证”

msgid “邮箱”
msgstr “邮箱”

msgid “邮编”
msgstr “邮编”

msgid “阅读更多”
msgstr “阅读更多”

msgid “首页”
msgstr “阅读更多”

msgid “验证码”
msgstr “验证码”
msgid “邮件验证”
msgstr “Email Verification”

msgid “邮箱”
msgstr “Email Box”

msgid “邮编”
msgstr “Postal Code”

msgid “阅读更多”
msgstr “Read More”

msgid “首页”
msgstr “Home Page”

msgid “验证码”
msgstr “Verification Code”