Babel 提取不到字符串、_() 不生效或编译报错，主因是未配置 babel.cfg、未指定 -F 参数、.mo 未生成、locale 未正确设置或 .po 文件编码/格式错误。
直接上手就能用，但多数人卡在提取不到字符串、_() 不生效、或编译报错这三步。Babel 本身不自动扫描模板或注入函数，所有行为都依赖显式配置和正确时机。
pybabel extract 提不出字符串？检查 babel.cfg 和命令参数
空 messages.pot 最常见原因：没配 babel.cfg，或配了但没在命令里加 -F babel.cfg。
-
babel.cfg必须包含[jinja2: **/templates/**.html]（Flask/Jinja2）或[python: **.py]（纯 Python），否则只扫默认路径（通常忽略templates/） - Jinja2 模板中写的是
{{ _('登录') }}，但默认规则不识别_，得在配置里显式加extract_messages = gettext ngettext _ lazy_gettext - 命令必须带
-F babel.cfg，否则它按内置规则跑，基本提不出模板里的内容 - 确保
input_dirs（如./app或./src）实际包含你的视图和模板目录
Flask 中 _() 返回原文？不是函数没调，是 .mo 没加载或 locale 未设置
翻译函数存在，但返回原字符串，说明 Babel 找不到对应语言的编译文件，或当前请求没绑定有效语言标识。
- 确认已运行
pybabel compile -d translations，生成了translations/zh/LC_MESSAGES/messages.mo（不是只有.po） -
Flask-Babel不会自动读 URL 或 cookie，必须自己写@babel.localeselector函数，并返回值在app.config['LANGUAGES']列表里 - 别直接返回
request.args.get('lang')，要校验白名单，否则 fallback 到None，导致所有翻译退化为原文 - 调试时可在路由开头强制设
g.lang_code = 'zh'，再在localeselector里返回它，快速验证是否是 locale 逻辑问题
编译 .po 报 “expected message id”？编码或格式污染了
这不是语法错误，而是文件被破坏了——90% 来自手动编辑后保存成非 UTF-8 或混入不可见字符。
- 用 VS Code 或 Notepad++ 打开
.po，右下角确认显示 “UTF-8”，不是 “UTF-8 with BOM” 或 “GBK” - 删掉所有以
#~开头的行（Babel 自动生成的废弃条目），旧版msgfmt会卡在这 - 运行
msgfmt -c zh/LC_MESSAGES/messages.po单独验证，比pybabel compile报错更明确 - 别从 Word 或网页复制翻译内容进去，引号、破折号容易变成全角或 Unicode 变体
最易被忽略的是：Babel 的 init_app() 必须在 Flask app 实例创建之后调用；还有 Jinja2 模板里 _() 能用，前提是 babel.init_app(app) 成功执行过——它负责把 _ 注入 app.jinja_env.globals，漏掉这步，模板里就真会报 UndefinedError。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
