Flask-Babel 4.0翻译不生效，始终默认显示英文问题排查

针对你遇到的翻译始终显示英文的情况，可按以下步骤逐一排查：

1. 修正翻译目录路径配置 #

相对路径./translations可能因Flask运行时的工作目录不同导致无法找到文件，建议改用绝对路径：

import os
app.config['BABEL_TRANSLATION_DIRECTORIES'] = os.path.join(app.root_path, 'translations')

2. 确认翻译文件目录结构合规 #

翻译文件必须遵循标准结构，示例如下：

translations/
├── en/
│   └── LC_MESSAGES/
│       ├── messages.po
│       └── messages.mo
├── zh/
│   └── LC_MESSAGES/
│       ├── messages.po
│       └── messages.mo
...

• 每个语言代码对应一个子目录（如zh、es）
• 子目录下必须包含LC_MESSAGES文件夹
• 翻译文件必须命名为messages.mo/.po（除非自定义了domain参数）

3. 优化Babel初始化逻辑 #

你当前重复初始化了Babel实例，可能导致locale_selector未正确绑定，修改为：

# 移除重复的babel = Babel(app)，直接初始化并绑定选择器
babel = Babel(app, locale_selector=get_locale)

4. 验证翻译文件编译正确性 #

• 打开对应语言的.po文件，确认存在目标翻译条目，例如中文：

  msgid "Generate"
  msgstr "生成"
  

• 重新编译翻译文件，确保无报错：

  pybabel compile -d translations
  

  编译后检查.mo文件的修改时间是否为最新。

5. 确认get_locale函数返回值正确 #

在get_locale中添加日志输出，验证返回的区域设置是否符合预期：

def get_locale():
    default_language = 'en'
    supported_languages = ['en', 'zh', 'es', 'fr']
    segments = request.path.split('/')
    selected_locale = default_language

    if segments and len(segments) > 1 and segments[1] in supported_languages:
        selected_locale = segments[1]
        g.locale = selected_locale
    else:
        g.locale = default_language
    
    print(f"Selected locale: {selected_locale}")  # 添加日志
    return selected_locale

运行后访问/zh/，查看控制台是否输出Selected locale: zh。

6. 排除模板上下文问题 #

在视图函数中直接调用_('Generate')并打印结果，验证翻译逻辑是否在后端正常工作：

@main.route('/')
@main.route('/<lang_code>/')
def index(lang_code='en'):
    print(f"Translated text: {_('Generate')}")  # 添加打印
    return render_template('index.html')

如果后端打印出翻译后的内容，但模板显示英文，再排查模板上下文是否正确导入了_函数。

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