Flask多语言核心是flask-babel自动加载.mo文件，而非手动字典切换；需确保babel.cfg路径覆盖、函数用lazy_gettext包裹、get_locale返回有效语言码、.mo置于translations/lang/LC_MESSAGES/下且重启服务生效。
Flask 中多语言国际化不是靠手动切换字典实现的，核心是让 flask-babel 在请求时自动加载对应语言的 .mo 文件，而 .po 文件只是中间编辑格式——编译不成功、路径不对、函数没包裹，都会导致翻译完全不生效。
pybabel extract 提取不到字符串？检查 babel.cfg 和标记函数
常见错误是运行 pybabel extract 后 messages.pot 为空，或只提取了部分字符串。根本原因通常是：
-
babel.cfg中的路径模式没覆盖到你的 Python 文件，比如写成[python: app/**/*.py]却把视图放在views/目录下 - 用了
_()但没导入，或误用gettext而没加-k gettext参数 - Flask-WTF 表单里用的是
lazy_gettext，但babel.cfg没声明extract_messages = lazy_gettext, gettext - Jinja2 模板里用了
{{ _('Login') }}，但babel.cfg缺少[jinja2: templates/**.html]段落
正确做法：确保 babel.cfg 包含完整规则，例如：
[python: **.py] keywords = _ gettext ngettext lazy_gettext [jinja2: **/templates/**.html] extensions = jinja2.ext.autoescape,jinja2.ext.with_
再执行：pybabel extract -F babel.cfg -k lazy_gettext -o messages.pot .
立即学习“Python免费学习笔记（深入）”；
翻译生效但总是显示英文？确认 get_locale() 返回值和 .mo 文件位置
即使 .po 文件已填满中文，页面仍显示英文，大概率是 flask-babel 没加载到中文 .mo。关键点有三个：
-
get_locale()函数必须返回明确语言代码（如'zh'或'zh_CN'），不能是None；如果用request.args.get('lang')，注意 URL 中传的是?lang=zh还是?lang=zh_CN，要跟app.config['BABEL_SUPPORTED_LOCALES']里的键一致 -
.mo文件必须放在translations/zh/LC_MESSAGES/messages.mo（注意大小写和目录层级），LC_MESSAGES不可省略，也不能写成lc_messages - 编译命令必须指定正确目录：
pybabel compile -d translations，不是pybabel compile -d ./translations或漏掉-d
调试建议：在 get_locale() 里加 print(f"locale: {locale}")，看实际返回值；检查 app.config['BABEL_TRANSLATION_DIRECTORIES'] 是否指向 translations 目录。
Flask-WTF 表单验证消息不翻译？必须用 lazy_gettext 初始化字段
普通字符串用 _() 就行，但 WTForms 字段定义在模块加载时就执行了，此时请求上下文不存在，gettext 会 fallback 到默认语言。所以：
- 字段定义必须用
from flask_babel import lazy_gettext as _，而不是from flask_babel import gettext as _ - 不能写
username = StringField(_('Username'), validators=[...])—— 这里_是普通gettext，会立即求值 - 正确写法是：
username = StringField(_('Username'), ...)，前提是_是lazy_gettext - Flask-WTF 的
ValidationError消息也需包裹，如raise ValidationError(_('Email is already registered.'))
否则，表单渲染时标签可能是中文，但提交失败后显示的错误消息永远是英文。
更新翻译后页面没变？别忘了重启服务 + 清浏览器缓存
pybabel compile 成功不代表立刻生效，有两个隐藏坑：
- Flask 开发服务器不会自动重载
.mo文件，改完必须手动重启flask run - 浏览器可能缓存了旧的响应（尤其是 304 Not Modified），强制刷新（
Ctrl+Shift+R）或禁用缓存调试更可靠 - 如果用 Gunicorn/uWSGI，需触发 worker 重启，或配置热重载（如
--reload）
最稳妥的验证方式：在 get_locale() 里临时硬编码 return 'zh'，再访问页面，排除语言协商逻辑干扰。
真正卡住人的从来不是“怎么配”，而是 messages.po 里少了一行 msgstr、LC_MESSAGES 多打了个下划线、或者 lazy_gettext 忘了 import —— 这些细节不报错，但翻译就是不出现。
