gettext 必须用 _() 包裹字符串，因为提取工具（如 xgettext）仅识别 _() 内的字面量字符串；未包裹的如 "Save" 不会被扫描，导致无法进入翻译流程；禁止变量拼接，应使用占位符。
gettext 为什么必须用 _() 包裹字符串
因为 gettext 的提取工具（如 xgettext）只识别带 _() 的字符串，不包裹就进不了翻译流程。不是语法强制，是工作流硬性约定。
常见错误现象：label = tk.Label(root, text="Save") —— 这个 "Save" 永远不会被扫描到，后续加翻译也白搭。
- 所有界面文案（按钮、提示、菜单项、标签文字）都得写成
_("Save") - 不要用变量拼接：❌
_("Hello " + name)；✅ 改用占位符：或 <code> - 如果用 f-string，必须确保翻译时能传参，推荐统一用
gettext.gettext()显式调用，避免 f-string 提前求值
如何生成 .pot 文件并更新 .po 文件
xgettext 是提取源码中所有 _() 字符串的唯一可靠方式，手动维护 .pot 几乎必然漏项。
使用场景：每次改完界面文案、新增控件后，都要重新提取。
立即学习“Python免费学习笔记（深入）”；
- 基础命令：
xgettext --from-code=UTF-8 -o messages.pot *.py（注意路径和文件名匹配） - 若用 tkinter，建议加
--keyword=_显式声明，避免某些环境误判 - 已有
.po文件时，用msgmerge -U zh_CN.po messages.pot合并新旧条目，保留已翻译内容 - 别直接编辑
.pot——它是模板，只读；翻译工作全在.po里做
Python 中加载 .mo 文件的典型路径陷阱
gettext.translation() 找不到 .mo 就静默回退到原文，根本不会报错，这是最隐蔽的坑。
关键参数是 localedir 和 languages，两者必须严格匹配实际目录结构。
- 标准结构应为：
locale/zh_CN/LC_MESSAGES/messages.mo，不是locale/zh_CN/messages.mo -
localedir要指向locale目录（不含zh_CN），例如：localedir=os.path.join(os.path.dirname(__file__), "locale") -
languages=["zh_CN"]必须和子目录名完全一致（区分大小写，带下划线），Windows 上尤其容易因大小写不敏感掩盖问题 - 调试方法：打印
trans._info看是否加载成功；或临时删掉.mo文件，确认是否真回退到英文
tkinter 动态切换语言为何常失效
tkinter 组件创建后，text 属性不会自动响应语言变更，必须手动刷新。
这不是 gettext 的问题，而是 GUI 框架生命周期决定的。
- 不能只调用
gettext.translation(...).install()就完事；全局_替换只影响后续新字符串 - 已有组件需逐个重设：
btn.config(text=_("Save"))、label["text"] = _("Loading...") - 推荐封装一个
retranslate_ui()方法，在语言切换后集中调用，避免遗漏 - 注意事件绑定里的字符串（如
command=lambda: messagebox.showinfo("Info", _("Done"))）也要重绑，否则点开还是旧语言
真正麻烦的从来不是加翻译，而是让所有运行中的 widget 实时响应变化——这点很容易被忽略，直到用户切语言后发现菜单变了但按钮没变。
