You need to enable JavaScript to run this app. Qt5中TS文件源串含换行字符时翻译匹配失效的处理方法
优惠活动
大模型
产品
解决方案
定价
更多

Qt5中TS文件源串含换行字符时翻译匹配失效的处理方法

TS文件含换行符翻译加载失效的处理方案

根因

TS文件为标准XML格式,你当前文件中写入的\n是反斜杠、字母n两个独立的普通字符,和C/C++运行时字符串里转义生成的真实换行符(ASCII 10)完全不是同一个内容,二者不匹配就会出现翻译查不到的问题——这也是你删掉换行后功能就能正常的核心原因。

操作规则

  • 禁止在TS的<source>/<translation>节点内直接书写字面\n字符,带换行的文本按以下两种合规方式编写:
    • 直接在节点内换行,写出多行文本,和运行时带换行的源字符串内容逐字符对齐
    • 使用XML通用实体&#10;代表真实换行符,效果和直接换行完全等价
  • 强制校验:运行时传入的待翻译源字符串,必须和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.&#10;It has a newline character.</source> -->
        <translation>对应翻译文本
同样带换行的译文内容</translation>
    </message>
</context>

避坑提示

  • 编辑带换行的TS文件优先使用Qt自带的Linguist工具,工具会自动处理换行的XML转义、格式对齐,手动硬写转义字符是最容易出现匹配偏差的操作
  • 动态生成TS文件的代码逻辑中,要将字符串内的真实换行做XML实体转义后再写入文件,不要直接把C字符串的字面\n硬塞到XML标签内部

内容的提问来源于stack exchange,提问作者Darin Beaudreau

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.18 04:27:07