CMake 3.17+执行Qt TS翻译更新流程时意外删除TS文件
CMake 3.17+ 环境下Qt翻译工作流误删TS文件问题解析
根因拆解
- 这不是CMake 3.17+的功能缺陷,本质是原有工作流逻辑与新版本引入的构建产物自动清理规则不兼容。
- CMake 3.17针对Ninja生成器做了核心行为变更:每次重新配置项目时,会自动扫描构建目录的Ninja规则文件,将所有历史登记为“构建产物”、但当前配置下不再被任何构建规则覆盖的文件,纳入自动清理范围。
- 这套工作流中的两个Qt翻译函数,对TS文件的角色定义存在本质差异:
- 开启
UPDATE_TRANSLATIONS=ON时调用qt5_create_translation:函数会将指定的TS文件识别为构建过程生成的中间产物,把TS文件路径登记到Ninja的可清理产物列表中。 - 切回
UPDATE_TRANSLATIONS=OFF时调用qt5_add_translation:函数会将同一份TS文件识别为编译输入依赖,不再把TS文件登记为构建产物。
- 开启
- 上述两种配置的切换,会让TS文件从“已登记的构建产物”变成“无构建规则覆盖的历史产物”,恰好命中CMake 3.17+的自动清理逻辑,最终导致TS文件被直接删除。
- 新旧版本的行为差异非常明确:CMake 3.16及更早版本不会在重新配置流程中主动执行跨配置的产物清理,因此原工作流在旧版本上可以正常运行,不会出现文件被删除的问题。
可落地的修复方案
- 方案1:严格分离翻译更新的构建目录,不要在同一个构建目录下来回切换
UPDATE_TRANSLATIONS配置。给翻译更新操作单独创建独立的build目录,执行完TS文件扫描更新后直接退出构建流程,回到常规编译的build目录开展后续开发,从根源上避免触发跨配置的清理逻辑。 - 方案2:在调用
qt5_create_translation时,明确给TS文件添加源码属性,告知CMake不要将这些TS文件纳入可清理产物范围。可以在CMakeLists.txt中添加如下配置:# 标记TS文件为非生成的源码输入,避免被纳入自动清理 set_source_files_properties(${_tsFiles} PROPERTIES GENERATED OFF HEADER_FILE_ONLY OFF ) - 方案3:避免在同一个CMakeLists.txt中通过条件判断切换翻译函数的调用逻辑,统一使用
qt5_create_translation的配置参数区分行为:默认关闭源码扫描,需要更新翻译时通过命令行传入对应的lupdate参数,无需来回切换CMake配置选项。
常见认知误区
- 无需因为这个问题回退到CMake 3.16版本:新版本的自动清理逻辑是为了避免构建目录残留陈旧的中间文件,本身是提升构建可靠性的正向功能,只是需要适配新的规则调整配置即可。
- 《Professional CMake(第7版)》中记录的对应工作流,是基于CMake 3.16及更早版本的行为设计的,在3.17之后的版本需要按照上述规则调整配置,才能保证流程正常运行。
内容的提问来源于stack exchange,提问作者Macintron
相关产品推荐
相关产品推荐

