如何在PySide中实现含动态变量字符串的国际化翻译？

核心原则 #

QTranslator要求待翻译的字符串是固定模板，不能直接把变量嵌入字符串后传入tr()，否则翻译工具无法识别通用模板，只会将带变量的具体内容当作待翻译文本，完全起不到国际化作用。

正确实现方式 #

1. 使用Qt原生arg()方法（推荐） #

和PyQt的用法一致，在tr()中传入带占位符的固定模板字符串，再通过arg()填充动态变量：

# 正确写法
translated_text = self.tr("Saved %1 in file %2").arg(datetime_str).arg(filename)

• 占位符用%1、%2...按顺序对应后续arg()的参数，Qt翻译系统会识别这个模板字符串，翻译时保留占位符位置，运行时再替换为实际变量。
• 注意：数字、日期等非字符串类型变量，建议先转为字符串再传入arg()，避免类型适配问题。

2. 结合Python格式化（不推荐，需特殊处理） #

如果习惯用Python的格式化方式，绝对不能直接将f-string传入tr()（比如self.tr(f"Saved {datetime} in file {filename}")），这会导致翻译工具无法捕获模板。可以先通过tr()翻译模板字符串，再进行Python格式化：

# 可行但不推荐的写法
template = self.tr("Saved {dt} in file {fn}")
translated_text = template.format(dt=datetime_str, fn=filename)

这种方式虽然能用，但Qt翻译工具对命名占位符的支持不如%n形式友好，部分翻译工具可能无法正确识别，优先推荐第一种方法。

常见错误规避 #

• 禁止直接传入已格式化的字符串：比如self.tr("Saved %s in file %s" % (datetime, filename))，这种写法下QTranslator看到的是填充后的具体文本，而非通用模板，无法进行有效翻译。
• 确保调用对象是QObject子类：只有继承自QObject的类才能使用self.tr()，非QObject类可使用QCoreApplication.translate()替代：

from PySide6.QtCore import QCoreApplication

translated_text = QCoreApplication.translate("ContextName", "Saved %1 in file %2").arg(datetime_str).arg(filename)

这里的"ContextName"是翻译上下文，用于区分不同模块的相同模板字符串。

内容的提问来源于stack exchange，提问作者Haru