gettext是Python标准库中唯一可靠且支持运行时热切换的国际化方案，需手动管理翻译对象、用StringVar或configure()动态更新控件文本，并配合正确生成的.po/.mo文件及中文字体设置。
用 gettext 实现运行时语言切换，不是启动时硬编码
Tkinter 本身不内置国际化支持，但 gettext 是 Python 标准库中唯一可靠、可热切换的方案。关键点在于：不能只调用一次 gettext.install() 就完事，必须自己管理翻译对象，并在切换语言时重新绑定到所有控件的 text、textvariable 等属性。
常见错误是把翻译字符串写死在 Label(text=_("Hello")) 里——这样初始化后就固定了，后续改语言不会更新。真正可行的方式是用 StringVar 或手动重设控件内容。
- 每个需要多语言的字符串都用
_()包裹，但只用于初始化或触发更新，不直接塞进控件构造参数 - 语言切换函数里要调用
locale.setlocale()+ 重建gettext.translation()对象 - 所有界面文本必须通过可变对象（如
StringVar）或显式调用widget.config(text=_(...))更新
目录结构和 .po 文件生成流程不能跳过
没正确的 .po 文件，gettext 就是空转。Python 源码里所有待翻译字符串必须先被 xgettext 扫描提取，否则加了 _() 也没用。
典型结构如下：
立即学习“Python免费学习笔记（深入）”；
app/ ├── main.py ├── locales/ │ ├── zh_CN/ │ │ └── LC_MESSAGES/ │ │ └── messages.po │ └── en_US/ │ └── LC_MESSAGES/ │ └── messages.po
生成 .po 的命令必须跑一遍：
xgettext --from-code=UTF-8 -o locales/messages.pot *.py
然后复制成各语言 .po 并翻译，再编译为 .mo：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
msgfmt -o locales/zh_CN/LC_MESSAGES/messages.mo locales/zh_CN/LC_MESSAGES/messages.po
-
messages.pot是模板，每次代码新增_()后都要重新生成并合并到各.po -
msgfmt编译后的.mo文件才是运行时加载的对象，.po仅用于人工编辑 - 路径中
LC_MESSAGES是硬性约定，不能改成lang或其他名字
语言切换按钮必须触发完整 UI 刷新，不是只改菜单文字
点击“中文”按钮后，如果只有菜单项变了，而标签、按钮、提示框还显示英文，说明刷新逻辑漏掉了控件树遍历。
最稳妥的做法是：定义一个 update_ui_text() 方法，在其中遍历所有需更新的控件，逐个调用 config(text=_(...)) 或更新 StringVar 值。不要依赖“自动重绘”。
示例片段：
def switch_language(lang_code):
global _
lang = gettext.translation('messages', localedir='locales', languages=[lang_code])
_ = lang.gettext
update_ui_text()
def update_ui_text():
title_var.set(_("Application Title"))
btn_ok.config(text=_("OK"))
label_status.config(text=_("Ready"))
- 避免用
root.winfo_children()递归遍历——嵌套 Frame 多时容易漏或重复 - 推荐把关键控件提前存入字典：
self.text_widgets = {"title": title_var, "btn_ok": btn_ok, ...} - 如果用了
ttk的Style配置了文字（比如style.configure("TButton", text=_("Submit"))），这部分也要单独刷新
中文 Windows 下 locale.setlocale() 经常静默失败
直接调 locale.setlocale(locale.LC_ALL, "zh_CN.UTF-8") 在 Windows 上大概率返回空字符串，且不报错，导致后续 gettext 加载默认语言（通常是英文）。
Windows 的 locale 名称和 Linux 不同，必须查系统实际支持的名称：
- 中文 Windows 常用的是
Chinese_China.936或zh_CN（部分新版本支持） - 安全做法是先尝试
locale.setlocale(locale.LC_ALL, "")让它读系统默认，再用locale.getlocale()查当前值 - 更推荐绕过
locale，直接用gettext.translation(..., languages=["zh_CN"])，不依赖系统 locale 设置
真正麻烦的是字体：Tkinter 默认不支持中文渲染，即使翻译正确，也可能显示方块。得手动设置控件 font 为支持中文的字体，比如 SimSun 或 Microsoft YaHei。
这事关体验，但不属于 gettext 职责范围——语言切换能跑通，只是第一步。
