Babel 提取 Flask 模板中文需配置 babel.cfg 的 [jinja2] 段，指定 extensions 和 extract_messages；locale 为 None 是因未设 @babel.localeselector；.po 编译报错多因编码非 UTF-8 或含 #~ 注释；字符串格式化须将 _() 作用于字面量而非运行时拼接结果。
怎么用 Babel 提取 Flask 模板里的中文字符串
默认情况下，pybabel extract 不会识别 .html 或 .jinja 里的 _() 或 gettext() 调用，尤其当模板用的是 {{ _('登录') }} 这种写法时，容易漏提。
必须显式告诉 Babel 模板语法和函数名：
- 在
babel.cfg中加[[jinja2]]段，并配置extensions = jinja2.ext.autoescape,jinja2.ext.with_ - 指定提取函数：在
babel.cfg的[jinja2: **/templates/**.html]行后加encoding = utf-8和extract_messages = gettext ngettext _ lazy_gettext - 运行命令时别漏
-F babel.cfg，否则它按默认规则跑，基本提不出东西
常见错误现象：pybabel extract -o messages.pot . 执行完 messages.pot 里空空如也，或只有 Python 文件里的字符串。
为什么 Flask-Babel 初始化后 request.locale 总是 None
不是插件没装好，而是 locale 选择逻辑没接上 —— FlaskBabel 默认不自动解析语言偏好，得自己写钩子。
立即学习“Python免费学习笔记（深入）”；
典型做法是用 @babel.localeselector 函数返回当前请求该用的语言代码：
- 优先读 URL 路径前缀（如
/zh/login），比 cookie 和Accept-Language更可控 - 别直接返回
request.args.get('lang')，它没做白名单校验，可能返回fr-FR这种不支持的值 - 返回前务必检查是否在
app.config['LANGUAGES'] = ['en', 'zh', 'ja']列表里，否则 Babel 会 fallback 到None
示例片段：
@babel.localeselector
def get_locale():
lang = request.path.split('/')[1]
if lang in app.config['LANGUAGES']:
return lang
return request.accept_languages.best_match(app.config['LANGUAGES'])
编译 .po 文件时报错 “expected message id, got …”
这是 pybabel compile 在读 .po 时遇到格式损坏，90% 是手动编辑 .po 后忘了保存为 UTF-8 编码，或混入了不可见字符（比如从 Word 复制过来的引号）。
实操建议：
- 用 VS Code 或 Notepad++ 打开
.po，确认右下角显示 “UTF-8”（不是 UTF-8 with BOM） - 删掉所有以
#~开头的注释行 —— 这些是 Babel 自动生成的废弃翻译，某些旧版msgfmt会卡在这里 - 运行
msgfmt -c zh/LC_MESSAGES/messages.po单独验证语法，比pybabel compile报错更明确
错误信息示例：error: expected message id, got "msgstr"，基本就是编码或残留注释导致的。
Python 字符串格式化和 _() 搭配时为啥翻译失效
_('{name} 登录成功'.format(name=user.name)) 这种写法，Babel 提取时看到的是运行时拼接结果，根本找不到原始可翻译字符串 —— 提取工具只扫描字面量，不执行代码。
正确姿势是把占位符留在翻译单元内，让 Babel 能静态识别：
- 用
_('{name} 登录成功')+.format(name=user.name)，注意_()只包纯字符串 - 更推荐用
gettext的ngettext风格占位符：_(u'%(name)s 登录成功') % {'name': user.name} - 如果用了
f-string，必须拆开：f"{_('欢迎')} {user.name}"，不能f"{'欢迎'} {user.name}"再套_()
性能影响不大，但漏掉这个细节，上线后一半文案就永远是英文。
最麻烦的其实是语言切换后模板缓存没清，或者 g.locale 没随请求重置 —— 这些问题不会报错，只会让你对着中文界面反复刷出英文，查半天才发现是中间件顺序错了。
