CMP0176

在版本 3.31 中添加。

execute_process() 的 ENCODING 选项默认值为 UTF-8。

ENCODING 选项仅在 Windows 上有意义。它指定了在进程的标准输出和标准错误中预期的字符编码。在 CMake 3.14 及更早版本中，默认编码为 NONE，这对应于 CMake 内部的 UTF-8 编码。在 CMake 3.15 到 CMake 3.30 版本中，默认编码意外更改为 AUTO，但这一更改未被注意到且未被记录。

CMake 3.31 及更高版本将 ENCODING 的默认值设置为 UTF-8。此策略旨在与可能依赖于默认值为 AUTO 的项目兼容。

此策略的 OLD 行为是，如果未指定 ENCODING，execute_process() 将默认使用 AUTO。此策略的 NEW 行为是将 UTF-8 作为默认的 ENCODING。

此策略引入于 CMake 版本 3.31。它可以通过 cmake_policy() 或 cmake_minimum_required() 进行设置。如果未设置，CMake 不会发出警告，并使用 OLD 行为。

注意

策略的 OLD 行为 根据定义已被弃用，并可能在未来的 CMake 版本中被移除。