Qt5中TS文件源串含换行字符时翻译匹配失效的处理方法
TS文件含换行符翻译加载失效的处理方案
根因
TS文件为标准XML格式,你当前文件中写入的\n是反斜杠、字母n两个独立的普通字符,和C/C++运行时字符串里转义生成的真实换行符(ASCII 10)完全不是同一个内容,二者不匹配就会出现翻译查不到的问题——这也是你删掉换行后功能就能正常的核心原因。
操作规则
- 禁止在TS的
<source>/<translation>节点内直接书写字面\n字符,带换行的文本按以下两种合规方式编写:- 直接在节点内换行,写出多行文本,和运行时带换行的源字符串内容逐字符对齐
- 使用XML通用实体
代表真实换行符,效果和直接换行完全等价
- 强制校验:运行时传入的待翻译源字符串,必须和TS中
<source>节点解析后的实际内容完全一致,不能出现一边是真实换行、另一边是字面转义写法的偏差
合规的TS文件示例如下:
<context> <name>MyContext</name> <message> <!-- 直接换行的多行写法 --> <source>The text that I'm trying to match. It has a newline character.</source> <!-- 单行实体写法,和上面的多行效果完全一致 --> <!-- <source>The text that I'm trying to match. It has a newline character.</source> --> <translation>对应翻译文本 同样带换行的译文内容</translation> </message> </context>
避坑提示
- 编辑带换行的TS文件优先使用Qt自带的Linguist工具,工具会自动处理换行的XML转义、格式对齐,手动硬写转义字符是最容易出现匹配偏差的操作
- 动态生成TS文件的代码逻辑中,要将字符串内的真实换行做XML实体转义后再写入文件,不要直接把C字符串的字面
\n硬塞到XML标签内部
内容的提问来源于stack exchange,提问作者Darin Beaudreau
相关产品推荐
相关产品推荐

