CMake中的变量: 改变构建行为的变量

变量名称	描述
BUILD_SHARED_LIBS	全局标志，用于在启用时使add_library()创建共享库。 如果存在并且为true，则这将导致所有库被构建为共享库，除非该库被明确添加为静态库。这个变量通常作为option()添加到项目中，这样项目的每个用户都可以决定是使用共享库还是静态库来构建项目。
CMAKE_ABSOLUTE_DESTINATION_FILES	使用绝对目的地路径安装的文件列表。 此变量由CMake生成的CMake_install.CMake脚本定义。它可以由源于这些安装脚本的程序或脚本使用（只读）。这被一些CPack生成器（例如RPM）使用。
CMAKE_ADD_CUSTOM_COMMAND_DEPENDS_EXPLICIT_ONLY	是否在add_custom_command()中默认启用DEPENDS_EXPLICIT_ONLY选项。
CMAKE_APPBUNDLE_PATH	以分号分隔的目录列表，指定find_program()和find_package()命令使用的macOS应用程序包的搜索路径。
CMAKE_BUILD_TYPE	指定单个配置生成器（例如Makefile generators或Ninja）上的生成类型。典型的值包括Debug、Release、RelWithDebInfo和MinSizeRel，但也可以定义自定义构建类型。 当首次创建新的构建树时，该变量由项目中调用的第一个project()或enable_language()命令初始化。如果设置了CMAKE_BUILD_TYPE环境变量，则使用其值。否则，在启用语言时，将选择特定于工具链的默认值。默认值通常是一个空字符串，但这通常是不可取的，其他标准构建类型通常更合适。
CMAKE_CLANG_VFS_OVERLAY	当使用clang cl为windows进行交叉编译时，此变量可以是指向clang虚拟文件系统yaml文件的绝对路径，这将使clang cl能够解析区分大小写的文件系统上的windows标头名称。
CMAKE_CODEBLOCKS_COMPILER_ID	更改生成的CodeBlocks项目文件中的编译器id。 CodeBlocks使用自己的编译器id字符串，该字符串不同于CMAKE__compiler_id。如果此变量为空，CMake将尝试自动识别CodeBlocks编译器id。否则，指定的字符串将在CodeBlocks项目文件中使用。有关有效的编译器id字符串，请参阅CodeBlocks文档。
CMAKE_CODEBLOCKS_EXCLUDE_EXTERNAL_FILES	更改CodeBlocks生成器创建项目文件的方式。 如果此变量的计算结果为ON，生成器将从项目文件中排除位于项目根目录之外的任何文件。
CMAKE_CODELITE_USE_TARGETS	更改CodeLite生成器创建项目文件的方式。 如果此变量在顶级CMakeLists.txt文件的末尾计算为ON，则生成器将基于目标而非项目创建项目文件。
CMAKE_COLOR_DIAGNOSTICS	全程启用颜色诊断。 此变量使用三种状态：ON、OFF和未定义。 未定义时：Makefile生成器将CMAKE_COLOR_Makefile变量初始化为ON。它控制颜色构建系统消息。GNU/Clang编译器不使用任何颜色诊断标志进行调用。 打开时：Makefile生成器默认情况下生成彩色构建系统消息。CMAKE_COLOR_MAKEFILE未初始化，但可以显式设置为OFF以禁用彩色构建系统消息。GNU/Clang编译器的调用带有启用颜色诊断的标志（-fcolor diagnostics）。 关闭时：默认情况下，Makefile生成器不会生成彩色构建系统消息。CMAKE_COLOR_MAKEFILE未初始化，但可以显式设置为ON以启用彩色构建系统消息。GNU/Clang编译器的调用带有禁用颜色诊断的标志（-fno颜色诊断）。 如果设置了CMAKE_COLOR_DIAGNOSTICS环境变量，则使用其值。否则，CMAKE_COLOR_DIAGNOSTICS为否
CMAKE_COLOR_MAKEFILE	使用Makefile生成器时启用颜色输出。 启用后，生成的Makefile将产生彩色输出。默认值为ON。
CMAKE_CONFIGURATION_TYPES	以分号分隔的列表形式指定多配置生成器（例如Visual Studio、Xcode或Ninja multi-config）上的可用生成类型（配置）。典型的条目包括Debug、Release、RelWithDebInfo和MinSizeRel，但也可以定义自定义构建类型。 当首次创建新的构建树时，该变量由项目中调用的第一个project()或enable_language()命令初始化。如果设置了CMAKE_CONFIGURATION_TYPES环境变量，则使用其值。否则，默认值是特定于生成器的。
CMAKE_DEPENDS_IN_PROJECT_ONLY	当在目录中设置为TRUE时，Makefile Generators生成的构建系统将被设置为仅考虑对出现在源目录或二进制目录中的源文件的依赖关系。对这些目录之外的源文件的更改不会导致重建。 在构建过程中通过外部头文件获取某些源文件的情况下，应谨慎使用此方法。
CMAKE_DISABLE_FIND_PACKAGE_	用于禁用find_package()调用的变量。 通过将变量CMAKE_DISABLE_find_package_设置为TRUE，可以禁用项目中的每个非REQUIRED find_package()调用。这可以用于构建没有可选包的项目，尽管该包已安装。
CMAKE_ECLIPSE_GENERATE_LINKED_RESOURCES	这个缓存变量由Eclipse项目生成器使用。
CMAKE_ECLIPSE_GENERATE_SOURCE_PROJECT	这个缓存变量由Eclipse项目生成器使用。
CMAKE_ECLIPSE_MAKE_ARGUMENTS	这个变量包含Eclipse调用make工具时使用的参数。默认情况下，它被初始化为保存标志以启用并行构建（通常使用-j）。
CMAKE_ECLIPSE_RESOURCE_ENCODING	这个缓存变量告诉EclipseCDT4项目生成器在生成的项目文件中将资源编码设置为给定值。如果未给定任何值，则不会设置任何编码。
CMAKE_ECLIPSE_VERSION	在使用Eclipse项目生成器时，CMake会尝试查找Eclipse可执行文件并检测其版本。根据找到的版本，某些功能会被启用或禁用。如果CMake找不到Eclipse，它将假定支持的最旧版本是EclipseCallisto（3.2）。
CMAKE_ERROR_DEPRECATED	是否为不推荐使用的功能发出错误。 如果为TRUE，则使用不推荐使用的功能将出现致命错误。如果未设置此变量，则CMake的行为就像设置为FALSE一样。
CMAKE_ERROR_ON_ABSOLUTE_INSTALL_DESTINATION	一旦遇到具有绝对install DESTINATION的文件，请要求cmake_install.cmake脚本出错。 致命错误是在安装有问题的文件之前发出的。此变量由CMake生成的CMake_install.CMake脚本使用。如果在运行脚本时将此变量设置为ON，则可能会收到来自脚本的致命错误消息。
CMAKE_EXECUTE_PROCESS_COMMAND_ECHO	如果此变量设置为STDERR、STDOUT或NONE，则execute_process()调用中的命令将打印到STDERR或STDOUT，或者根本不打印。
CMAKE_EXPORT_COMPILE_COMMANDS	在生成期间启用/禁用编译命令的输出。
CMAKE_EXPORT_PACKAGE_REGISTRY	当CMP0090设置为NEW时，启用导出（PACKAGE）命令。
CMAKE_EXPORT_NO_PACKAGE_REGISTRY	CMP0090未设置为NEW时，禁用export（PACKAGE）命令。
CMAKE_FIND_APPBUNDLE	此变量影响find_*命令如何在macOS应用程序包和unix风格的包组件之间进行选择。
CMAKE_FIND_FRAMEWORK	在Darwin或支持macOS应用程序捆绑包的系统上，CMAKE_FIND_APPBUNDLE变量可以设置为空或以下值之一： FIRST：尝试在标准程序之前查找应用程序捆绑包。这是达尔文的默认设置。 LAST：尝试在标准程序之后查找应用程序捆绑包。 ONLY：仅尝试查找应用程序捆绑包。 NEVER：永远不要尝试查找应用程序捆绑包。
CMAKE_FIND_LIBRARY_CUSTOM_LIB_SUFFIX	指定一个＜suffix＞来告诉find_library()命令在通常要搜索的每个lib目录之前先在lib＜suffx＞目录中进行搜索。 这将覆盖相关全局属性的行为： FIND_LIBRARY_USE_LIB32_path FIND_LIBRARY_USE_LIB64_path FIND_LIBRARY_USE_LIBX32_path
CMAKE_FIND_LIBRARY_PREFIXES	查找库时要前置的前缀。 这指定在find_library()命令查找库时要添加到库名称的前缀。在UNIX系统上，这通常是lib，这意味着当试图查找foo库时，它将查找libfoo。
CMAKE_FIND_LIBRARY_SUFFIXES	查找库时要附加的后缀。 这指定在find_library()命令查找库时要添加到库名称的后缀。在Windows系统上，这通常是.lib，根据编译器的不同，还有.dll.a、.a（例如GCC和Clang），因此当它试图查找foo库时，它会查找[]foo.lib和/或[]foo[.dll].a，这取决于所使用的编译器和CMAKE_find_library_PREFIXES中指定的。
CMAKE_FIND_NO_INSTALL_PREFIX	从CMAKE_SYSTEM_PREFIX_PATH中排除CMAKE_INSTALL_PREFIX和CMAKE_STAGING_PREFIX变量的值。默认情况下，CMake会将这些项目目标前缀添加到CMake_SYSTEM_PREFIX_PATH中，以支持构建一系列依赖包并将其安装到公共前缀中。将CMAKE_FIND_NO_INSTALL_PREFIX设置为TRUE可抑制此行为。 CMAKE_SYSTEM_PREFIX_PATH在第一次调用project()或enable_language()命令时初始化。因此，必须在此之前设置CMAKE_FIND_NO_INSTALL_PREFIX才能生效。用户可以在命令行上将变量设置为高速缓存条目来实现这一点。 请注意，由于其他原因，前缀仍可能被搜索，例如与CMake安装的前缀相同，或者是内置的系统前缀。
CMAKE_FIND_PACKAGE_PREFER_CONFIG	如果未指定模式，请告诉find_package()在"Module"模式之前尝试"配置"模式。 当在没有MODULE选项的情况下使用缩减签名时，命令find_package()在没有显式模式的情况下运行。在这种情况下，默认情况下，CMake首先通过搜索Find.CMake模块来尝试Module模式。如果失败，CMake将使用Config模式搜索包。 将CMAKE_FIND_PACKAGE_PREFER_CONFIG设置为TRUE，告诉FIND_PACKAGE()在返回模块模式之前先使用配置模式进行搜索。 当开发人员编译了通用库的自定义版本并希望将其链接到依赖项目时，此变量可能很有用。如果此变量设置为TRUE，则在查找开发人员自定义构建的库之前，将阻止依赖项目对find_package()的调用选择系统的find.cmake模块所定位的默认库。
CMAKE_FIND_PACKAGE_RESOLVE_SYMLINKS	设置为TRUE可告诉find_package()调用解析_DIR值中的符号链接。 这在包搜索路径指向代理目录的用例中很有帮助，在该目录中会出现指向实际包位置的符号链接。默认情况下，这是不启用的，因为也有一些常见的用例应该保留符号链接。
CMAKE_FIND_PACKAGE_TARGETS_GLOBAL	设置为TRUE会将find_package()发现的所有IMPORTED目标提升到全局作用域。 将其设置为TRUE类似于将GLOBAL指定为find_package()的参数。默认值为OFF。
CMAKE_FIND_PACKAGE_WARN_NO_MODULE	如果在没有显式模式的情况下调用，请告诉find_package()发出警告。
CMAKE_FIND_ROOT_PATH	要在文件系统上搜索的根路径的分号分隔列表。 此变量在交叉编译时最有用。CMake使用此列表中的路径作为替代根，以查找具有find_package()、find_library()等的文件系统项。
CMAKE_FIND_ROOT_PATH_MODE_INCLUDE	此变量控制FIND_FILE()和FIND_PATH()是否使用CMAKE_FIND_ROOT_PATH和CMAKE_SYSROOT。 如果设置为ONLY，则只搜索CMAKE_FIND_ROOT_PATH中的根。如果设置为"NEVER"，则CMAKE_FIND_ROOT_PATH中的根将被忽略，并且只使用主机系统根。如果设置为BOTH，则将搜索主机系统路径和CMAKE_FIND_ROOT_PATH中的路径。
CMAKE_FIND_ROOT_PATH_MODE_LIBRARY	此变量控制find_library()是否使用CMAKE_FIND_ROOT_PATH和CMAKE_SYSROOT。 如果设置为ONLY，则只搜索CMAKE_FIND_ROOT_PATH中的根。如果设置为"NEVER"，则CMAKE_FIND_ROOT_PATH中的根将被忽略，并且只使用主机系统根。如果设置为BOTH，则将搜索主机系统路径和CMAKE_FIND_ROOT_PATH中的路径。
CMAKE_FIND_ROOT_PATH_MODE_PACKAGE	此变量控制find_package()是否使用CMAKE_FIND_ROOT_PATH和CMAKE_SYSROOT。 如果设置为ONLY，则只搜索CMAKE_FIND_ROOT_PATH中的根。如果设置为"NEVER"，则CMAKE_FIND_ROOT_PATH中的根将被忽略，并且只使用主机系统根。如果设置为BOTH，则将搜索主机系统路径和CMAKE_FIND_ROOT_PATH中的路径。
CMAKE_FIND_ROOT_PATH_MODE_PROGRAM	此变量控制find_program()是否使用CMAKE_FIND_ROOT_PATH和CMAKE_SYSROOT。 如果设置为ONLY，则只搜索CMAKE_FIND_ROOT_PATH中的根。如果设置为"NEVER"，则CMAKE_FIND_ROOT_PATH中的根将被忽略，并且只使用主机系统根。如果设置为BOTH，则将搜索主机系统路径和CMAKE_FIND_ROOT_PATH中的路径。
CMAKE_FIND_USE_CMAKE_ENVIRONMENT_PATH	控制以下命令的默认行为，以确定是否搜索cmake特定环境变量提供的路径： find_program() find_file() find_library() find_package() find_path() 这在交叉编译环境中非常有用。默认情况下，不设置此变量，这相当于它的值为TRUE。为上述命令提供的显式选项优先于此变量。
CMAKE_FIND_USE_CMAKE_PATH	控制以下命令的默认行为，以确定是否搜索cmake特定环境变量提供的路径： find_program() find_file() find_library() find_package() find_path() 这在交叉编译环境中非常有用。默认情况下，不设置此变量，这相当于它的值为TRUE。为上述命令提供的显式选项优先于此变量。
CMAKE_FIND_USE_CMAKE_SYSTEM_PATH	控制以下命令的默认行为，以确定是否搜索cmake特定环境变量提供的路径： find_program() find_file() find_library() find_package() find_path() 这在交叉编译环境中非常有用。默认情况下，不设置此变量，这相当于它的值为TRUE。为上述命令提供的显式选项优先于此变量。
CMAKE_FIND_USE_INSTALL_PREFIX	控制以下命令的默认行为，以确定是否搜索CMAKE_INSTALL_PREFIX和CMAKE_STAGING_PREFIX变量中的位置。 find_program() find_file() find_library() find_package() find_path() 这在交叉编译环境中非常有用。由于与CMAKE_FIND_NO_INSTALL_PREFIX的向后兼容性，FIND命令的行为会根据此变量是否存在而更改。
CMAKE_FIND_USE_PACKAGE_REGISTRY	控制find_package()命令的默认行为，用于是否搜索用户包注册表提供的路径。 默认情况下，未设置此变量，并且行为将回退到不推荐使用的CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY变量所确定的行为。如果也未设置，则find_package()将使用用户包注册表，除非提供了NO_CMAKE_package_Registry选项。 当两者都设置时，此变量优先于CMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY。 在某些情况下，例如，为了只定位系统范围内的安装，在搜索包时不希望使用用户包注册表。如果CMAKE_FIND_USE_PACKAGE_REGISTRY变量为FALSE，则所有FIND_PACKAGE()命令都将跳过用户程序包注册表，就像它们是用NO_CMAKE_PACKAGE_REGISTRY参数调用的一样。
CMAKE_FIND_USE_PACKAGE_ROOT_PATH	控制以下命令的默认行为，以确定是否搜索_ROOT变量提供的路径： find_program() find_file() find_library() find_package() find_path() 默认情况下，不设置此变量，这相当于它的值为TRUE。为上述命令提供的显式选项优先于此变量。
CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH	控制以下命令的默认行为，以确定是否搜索标准系统环境变量提供的路径： find_program() find_file() find_library() find_package() find_path() 这在交叉编译环境中非常有用。默认情况下，不设置此变量，这相当于它的值为TRUE。为上述命令提供的显式选项优先于此变量。
CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY	控制通过find_Package()命令搜索系统包注册表。 默认情况下，未设置此变量，并且行为将回退到不推荐使用的CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY变量所确定的行为。如果也未设置，则find_package()将使用系统包注册表，除非提供了NO_CMAKE_System_package_Registry选项。 当两者都设置时，此变量优先于CMAKE_FIND_PACKAGE_NO_SYSTEM_PACKAGE_REGISTRY。 在某些情况下，例如，为了只定位用户特定的安装，在搜索包时不希望使用系统包注册表。如果CMAKE_FIND_USE_SYSTEM_PACKAGE_REGISTRY变量为FALSE，则所有FIND_PACKAGE()命令都将跳过系统包注册表，就像它们是用NO_CMAKE_SYSTEM-PACKAGE_REGISTRY参数调用的一样。
CMAKE_FRAMEWORK_PATH	以分号分隔的目录列表，指定find_library()、find_package()、find_path()和find_file()命令使用的macOS框架的搜索路径。
CMAKE_IGNORE_PATH	对于find_program()、find_library()、find_file()和find_path()，在其中一个列出的目录中找到的任何文件都将被忽略。列出的目录不递归应用，因此任何要忽略的子目录也必须显式列出。CMAKE_IGNORE_PATH不会影响这四个命令使用的搜索前缀。要忽略搜索前缀下的各个路径（例如bin、include、lib等），每个路径必须在CMAKE_ignore_path中作为完整的绝对路径列出。CMAKE_IGNORE_REFIX_PATH提供了一种更合适的方法来忽略整个搜索前缀。 find_package()也会受到CMAKE_IGNORE_PATH的影响，但仅适用于配置模式搜索。在其中一个指定目录中找到的任何＜Name＞Config.cmake或＜Name＞-Config.cmake文件都将被忽略。此外，由于向后兼容性的原因，在CMAKE_IGNORE_PATH中找到的任何搜索前缀都将被跳过，但新代码应该更喜欢
CMAKE_IGNORE_PREFIX_PATH	要由find_program()、find_library()、find_file()和find_path()命令忽略的搜索前缀的分号分隔列表。find_package()命令的Config模式也会忽略前缀（Module模式不受影响）。要忽略特定目录，请参阅CMAKE_ignore_PATH。 在某些系统目录包含不兼容但可能可链接的库的交叉编译环境中，忽略搜索位置可能很有用。例如，在交叉编译的集群环境中，这允许用户忽略包含用于前端机器的库的目录。 默认情况下，CMAKE_IGNORE_PREFIX_PATH为空。它是由项目或最终用户设置的。
CMAKE_INCLUDE_DIRECTORIES_BEFORE	默认情况下，是否在include_directories()中附加或预附加目录。 此变量影响include_directories()命令的默认行为。将该变量设置为ON相当于在该命令的所有使用中使用BEFORE选项。
CMAKE_INCLUDE_DIRECTORIES_PROJECT_BEFORE	是否强制准备项目包含目录。 此变量影响编译器命令行中生成的include目录的顺序。如果设置为ON，则会首先出现CMAKE_SOURCE_DIR和CMAKE_BINARY_DIR。
CMAKE_INCLUDE_PATH	用分号分隔的目录列表，指定find_file()和find_path()命令的搜索路径。默认情况下，它为空，由项目设置。 还有一个环境变量CMAKE_INCLUDE_PATH，用作搜索目录的附加列表。
CMAKE_INSTALL_DEFAULT_COMPONENT_NAME	install()命令中使用的默认组件。 如果使用install()命令而不使用COMPONENT参数，则这些文件将被分组到默认组件中。此默认安装组件的名称将取自此变量。它默认为"Unspecified"。
CMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS	install()和file(install)在安装文件期间隐式创建的目录的默认权限。 如果调用make-install并隐式创建目录，则它们将获得由CMAKE_install_DEFAULT_DIRECTORY_permissions变量设置的权限，如果未设置该变量，则获得特定于平台的默认权限。 如果未通过install()命令显式安装但需要在特定路径上安装文件，则会创建隐式创建的目录。此类位置的示例是由于设置CMAKE_INSTALL_PREFIX而创建的目录。 CMAKE_INSTALL_DEFAULT_DIRECTORY_PERMISSIONS变量的预期内容是INSTALL()命令PERMISSIONS部分可以使用的权限列表。
CMAKE_INSTALL_MESSAGE	CMAKE_INSTALL_MESSAGE变量可以设置为控制打印哪些消息： ALWAYS：打印“正在安装”和“最新”消息。 LAZY：打印正在安装但不是最新消息。 NEVER：既不打印“正在安装”消息，也不打印最新消息。 其他值具有未定义的行为，可能无法诊断。 如果未设置此变量，则默认行为为ALWAYS。
CMAKE_INSTALL_PREFIX	Install()使用的安装目录。 如果调用了make-install或生成了install，则该目录将预先添加到所有安装目录中。此变量在UNIX上默认为/usr/local，在Windows上默认为c:/Program Files/$｛PROJECT_NAME｝。
CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT	当CMake_INSTALL_PREFIX刚刚初始化为其默认值时，通常在新构建树中首次运行CMake时，CMake会将此变量设置为TRUE值。
CMAKE_KATE_FILES_MODE	此缓存变量由Kate项目生成器使用，并控制将项目文件中的文件条目设置为何种模式。 可能的值有AUTO、SVN、GIT、HG、FOSSIL和LIST。 当设置为LIST时，CMake将把CMake已知的源文件列表放在项目文件中。当设置为SVN、GIT、HG或FOSSIL时，CMake将相应地将生成的项目设置为Subversion、GIT、Mercurial或FOSSIL，然后Kate将使用相应的命令行工具检索项目中的文件列表。当取消设置或设置为AUTO时，CMake将尝试检测源目录是否是git或svn签出的一部分，并将相应的条目放入项目文件中。
CMAKE_KATE_MAKE_ARGUMENTS	此缓存变量由Kate项目生成器使用。 这个变量包含Kate调用make工具时使用的参数。默认情况下，它被初始化为保存标志以启用并行构建（通常使用-j）。
CMAKE_LIBRARY_PATH	用分号分隔的目录列表，指定find_library()命令的搜索路径。默认情况下，它为空，由项目设置。 还有一个环境变量CMAKE_LIBRARY_PATH，用作搜索目录的附加列表。
CMAKE_LINK_DIRECTORIES_BEFORE	默认情况下，是在link_directories()中附加目录还是预附加目录。 此变量影响link_directories()命令的默认行为。将该变量设置为ON相当于在该命令的所有使用中使用BEFORE选项。
CMAKE_LINK_LIBRARIES_ONLY_TARGETS	设置此变量可在创建非导入目标时初始化其LINK_LIBRARIES_ONLY_TARGETS属性。将其设置为true可以额外检查target_link_libraries()命名的所有可以作为目标名称的项是否都是现有目标的名称。有关详细信息，请参阅目标属性文档。
CMAKE_MAXIMUM_RECURSION_DEPTH	CMake脚本的最大递归深度。它打算在命令行上用-DCMAKE_MAXIMUM_RECURSION_DEPTH=设置，或者由需要大递归深度的项目在CMakeLists.txt中设置。
CMAKE_MESSAGE_CONTEXT	当cmake–log上下文命令行选项或CMAKE_MESSAGE_CONTEXT_SHOW变量启用时，MESSAGE()命令会将CMAKE_MESSAGE_CONTEXT列表转换为一个由方括号包围的点分隔字符串，并将其置于日志级别NOTICE及以下消息的每一行之前。 为了有效地记录上下文，项目通常应该将一个项APPEND和POP_BACK添加到CMAKE_MESSAGE_CONTEXT的当前值，而不是替换它。项目不应该假设源树顶部的消息上下文为空，因为在某些情况下，上下文可能已经设置好了（例如分层项目）。
CMAKE_MESSAGE_CONTEXT_SHOW	将此变量设置为true可以显示message()命令记录的每一行的上下文（有关上下文本身的指定方式，请参阅CMAKE_MESSAGE_CONTEXT）。 此变量是在cmake命令行上提供–log上下文选项的替代选项。尽管命令行选项将仅适用于该一次CMake运行，但将CMake_MESSAGE_CONTEXT_SHOW设置为true作为缓存变量将确保后续CMake的运行将继续显示消息上下文。 项目不应设置CMAKE_MESSAGE_CONTEXT_SHOW。它适用于用户，以便他们可以控制是否在消息中包含上下文。
CMAKE_MESSAGE_INDENT	message()命令连接该列表中的字符串，对于NOTICE及以下的日志级别，它会在消息的每一行中预先添加结果字符串。
CMAKE_MESSAGE_LOG_LEVEL	设置时，此变量指定message()命令使用的日志记录级别。有效值与cmake程序的–log级别命令行选项的有效值相同。如果设置了此变量，并提供了–log级别的命令行选项，则命令行选项优先。 使用此变量的主要优点是在CMake运行之间保持日志级别。将其设置为缓存变量将确保后续CMake运行将继续使用所选的日志级别。 项目不应该设置这个变量，它是为用户准备的，这样他们就可以根据自己的需要控制日志级别。
CMAKE_MFC_FLAG	将MFC库用于可执行文件或dll。 允许使用Microsoft基础类（MFC）。对于静态MFC库，它应该设置为1，对于共享MFC库，应该设置为2。这在Visual Studio项目文件中使用。
CMAKE_MODULE_PATH	以分号分隔的目录列表，使用正斜杠表示，在检查CMake附带的默认模块之前，指定要由include()或find_package()命令加载的CMake模块的搜索路径。默认情况下为空。它将由项目设置。
CMAKE_POLICY_DEFAULT_CMP	CMake Policy CMP＜NNNN＞在其他情况下未设置时的默认值。
CMAKE_POLICY_WARNING_CMP	当CMake_Policy()未显式或CMake_minimum_required()未隐式设置CMake Policy CMP＜NNNN＞时，显式启用或禁用警告。
CMAKE_PREFIX_PATH	用分号分隔的目录列表，指定find_package()、find_program()、find_library()、查找_file()和查找路径()命令要搜索的安装前缀。每个命令都会根据自己的文档中的指定添加适当的子目录（如bin、lib或include）。 默认情况下，此字段为空。它将由项目设置。 还有一个环境变量CMAKE_PREFIX_PATH，用作搜索前缀的附加列表。
CMAKE_PROGRAM_PATH	用分号分隔的目录列表，指定find_program()命令的搜索路径。默认情况下，它为空，由项目设置。 还有一个环境变量CMAKE_PROGRAM_PATH，用作搜索目录的附加列表。
CMAKE_PROJECT_INCLUDE	要作为所有project()命令调用的最后一步包含的CMake语言文件或模块。这是为了在不修改源代码的情况下将自定义代码注入到项目构建中。
CMAKE_PROJECT_INCLUDE_BEFORE	要作为所有project()命令调用的第一步包含的CMake语言文件或模块。这是为了在不修改源代码的情况下将自定义代码注入到项目构建中。。
CMAKE_PROJECT__INCLUDE	CMake语言文件或模块，作为指定＜project-NAME＞为项目名称的任何project()命令调用的最后一步。这是为了在不修改源代码的情况下将自定义代码注入到项目构建中。
CMAKE_PROJECT__INCLUDE_BEFORE	作为任何指定＜project-NAME＞为项目名称的project()命令调用的第一步，要包含的CMake语言文件或模块。这是为了在不修改源代码的情况下将自定义代码注入到项目构建中。
CMAKE_PROJECT_TOP_LEVEL_INCLUDES	要作为第一个project()调用的一部分包含的CMake语言文件的分号分隔列表。在读取工具链文件（如果指定了一个）并设置平台变量之后，但在启用任何语言之前，这些文件将立即包含在内。因此，可能不会设置特定于语言的变量，包括CMAKE__COMPILER。
CMAKE_REQUIRE_FIND_PACKAGE_	用于调用find_package()的变量REQUIRED。 通过将变量CMAKE_REQUIRE_FIND_PACKAGE_设置为TRUE，可以将项目中的每个非REQUIRED find_package()调用转换为REQUIRED。这可以用来断言关于构建环境的假设，并确保如果这些假设不成立，构建将提前失败。
CMAKE_SKIP_INSTALL_ALL_DEPENDENCY	不要让安装目标依赖于所有目标。 默认情况下，安装目标取决于所有目标。这样做的效果是，当调用makeinstall或构建install时，首先构建所有目标，然后开始安装。如果CMAKE_SKIP_INSTALL_ALL_DEPENDENCY设置为TRUE，则不会创建此依赖项，因此安装过程将立即启动，与项目是否已完全构建无关。
CMAKE_STAGING_PREFIX	此变量可以设置为交叉编译时要安装到的路径。如果CMAKE_SYSROOT中的路径是只读的，或者应该保持原始状态，那么这可能很有用。 CMAKE_STAGING_PREFIX位置也被find_*命令用作搜索前缀。这可以通过设置CMAKE_FIND_NO_INSTALL_PREFIX变量来控制。 如果传递给链接器的任何RPATH/RUNPATH条目包含CMAKE_STAGING_PREFIX，则匹配的路径片段将替换为CMAKE_INSTALL_PREFIX。
CMAKE_SUBLIME_TEXT_2_ENV_SETTINGS	此变量包含一个env-var列表，作为语法为var=value的令牌列表
CMAKE_SUBLIME_TEXT_2_EXCLUDE_BUILD_TREE	如果此变量在顶级CMakeLists.txt文件的末尾计算为ON，则Sublime Text 2额外生成器会将构建树从.spreme项目中排除（如果它在源树中）。
CMAKE_SUPPRESS_REGENERATION	如果默认情况下CMAKE_SUPPRESS_REGERATION为OFF，则CMAKE会添加一个所有其他目标所依赖的特殊目标，该目标将检查生成系统，并在目标规范源更改时重新运行CMAKE以重新生成生成系统。 如果此变量在顶级CMakeLists.txt文件的末尾计算为ON，则CMake将不会向生成系统添加重新生成目标，也不会执行任何生成系统检查。
CMAKE_SYSROOT	在–sysroot标志中传递给编译器的路径。 CMAKE_SYSROOT内容在–SYSROOT标志中传递给编译器（如果支持的话）。如果安装时需要，该路径也会从RPATH/RUNPATH中剥离。CMAKE_SYSROOT还用于为find_*命令搜索的路径添加前缀。 只能在CMAKE_TOOLCHAIN_FILE变量指定的工具链文件中设置此变量。
CMAKE_SYSROOT_COMPILE	编译源文件时在–sysroot标志中传递给编译器的路径。这与CMAKE_SYSROOT相同，但仅用于编译源，而不用于链接。
CMAKE_SYSROOT_LINK	链接时在–sysroot标志中传递给编译器的路径。这与CMAKE_SYSROOT相同，但仅用于链接而非编译源。
CMAKE_SYSTEM_APPBUNDLE_PATH	find_program()和find_package()命令使用的macOS应用程序包的搜索路径。默认情况下，它包含当前系统的标准目录。项目不打算修改它，请使用CMAKE_APPBUNDLE_PATH。
CMAKE_SYSTEM_FRAMEWORK_PATH	find_library()、find_package()、find_path()和find_file()命令使用的macOS框架的搜索路径。默认情况下，它包含当前系统的标准目录。项目不打算修改它，请使用CMAKE_FRAMEWORK_PATH。
CMAKE_SYSTEM_IGNORE_PATH	以分号分隔的目录列表将被各种find_*()命令忽略。
CMAKE_SYSTEM_IGNORE_PREFIX_PATH	要由find_program()、find_library()、find_file()和find_path()命令忽略的搜索前缀的分号分隔列表。find_package()命令的Config模式也会忽略前缀（Module模式不受影响）。
CMAKE_SYSTEM_INCLUDE_PATH	用分号分隔的目录列表，指定find_file()和find_path()命令的搜索路径。默认情况下，它包含当前系统的标准目录。
CMAKE_SYSTEM_LIBRARY_PATH	用分号分隔的目录列表，指定find_library()命令的搜索路径。默认情况下，它包含当前系统的标准目录。
CMAKE_SYSTEM_PREFIX_PATH	用分号分隔的目录列表，指定find_package()、find_program()、find_library()、find_file()和find_path()命令要搜索的安装前缀。每个命令都会根据自己的文档中的指定添加适当的子目录（如bin、lib或include）。 默认情况下，它包含当前系统的系统目录、CMAKE_INSTALL_PREFIX和CMAKE_STAGING_PREFIX。通过在第一次project()调用之前设置CMAKE_FIND_NO_INSTALL_PREFIX变量，可以排除安装和暂存前缀。 CMAKE_SYSTEM_PREFIX_PATH中包含的系统目录是通常包括已安装软件的位置。一个示例是基于UNIX的平台的/usr/local。除了标准平台位置外，CMake还将根据环境变量向CMake_SYSTEM_PREFIX_PATH添加值。CMake使用的环境变量和搜索位置可能会随着时间的推移而变化，因为平台及其约定: CrayLinuxEnvironment: ENV{SYSROOT_DIR}/ ENV{SYSROOT_DIR}/usr ENV{SYSROOT_DIR}/usr/local Darwin: ENV{SDKROOT}/usr When CMAKE_OSX_SYSROOT is not explicitly specified. OpenBSD: ENV{LOCALBASE} Unix: ENV{CONDA_PREFIX} when using a conda compiler MSYSTEM environment with MinGW toolchain: New in version 3.28. ENV{MSYSTEM_PREFIX}/local ENV{MSYSTEM_PREFIX} Windows: ENV{ProgramW6432} ENV{ProgramFiles} ENV{ProgramFiles(x86)} ENV{SystemDrive}/Program Files ENV{SystemDrive}/Program Files (x86)
CMAKE_SYSTEM_PROGRAM_PATH	用分号分隔的目录列表，指定find_program()命令的搜索路径。默认情况下，它包含当前系统的标准目录。
CMAKE_TLS_CAINFO	指定file(DOWNLOAD)和file(UPLOAD)命令的TLS_CAINFO选项的默认值。默认情况下未设置。 ExternalProject和FetchContent模块也使用此变量进行内部文件调用file(DOWNLOAD)。
CMAKE_TLS_VERIFY	为file(DOWNLOAD)和file(UPLOAD)命令的TLS_VERIFY选项指定默认值。如果未设置，则默认设置为禁用。 ExternalProject和FetchContent模块也使用此变量进行内部文件调用file(DOWNLOAD)。 TLS验证可以帮助提供连接到所需服务器的信心。下载已知内容时，还应该使用文件哈希进行验证。
CMAKE_USER_MAKE_RULES_OVERRIDE	指定替代平台信息的CMake文件。
CMAKE_WARN_DEPRECATED	是否对不推荐使用的功能发出警告。
CMAKE_WARN_ON_ABSOLUTE_INSTALL_DESTINATION	每次遇到具有绝对install DESTINATION的文件时，请要求cmake_install.cmake脚本发出警告。 此变量由CMake生成的CMake_install.CMake脚本使用。如果在运行脚本时将此变量设置为ON，则可能会收到来自脚本的警告消息。
CMAKE_XCODE_GENERATE_SCHEME	如果启用，Xcode生成器将生成模式文件。这些对于从命令行调用分析、归档、构建以进行测试和测试操作非常有用。
CMAKE_XCODE_GENERATE_TOP_LEVEL_PROJECT_ONLY	如果启用，Xcode生成器将只为最顶层的project()命令生成一个Xcode项目文件，而不是为每个project()。
CMAKE_XCODE_LINK_BUILD_PHASE_MODE	此变量用于初始化目标上的XCODE_LINK_BUILD_PHASE_MODE属性。它会影响Xcode生成器用来链接不同类型库的方法。其默认值为NONE。
CMAKE_XCODE_SCHEME_ADDRESS_SANITIZER	是否在生成的Xcode方案的Diagnostics部分启用Address Sanitizer。 此变量初始化所有目标上的XCODE_SCHEME_ADDRESS_SANITIZER属性。
CMAKE_XCODE_SCHEME_ADDRESS_SANITIZER_USE_AFTER_RETURN	在生成的Xcode方案的Diagnostics部分中，是否启用返回后检测堆栈的使用。
CMAKE_XCODE_SCHEME_DEBUG_DOCUMENT_VERSIONING	在生成的Xcode方案的“选项”部分中使用文档版本浏览器时，是否启用“允许调试”。
CMAKE_XCODE_SCHEME_DISABLE_MAIN_THREAD_CHECKER	是否在生成的Xcode方案的诊断部分禁用主线程检测器。
CMAKE_XCODE_SCHEME_DYNAMIC_LIBRARY_LOADS	是否在生成的Xcode方案的“诊断”部分中启用“动态库加载”。
CMAKE_XCODE_SCHEME_DYNAMIC_LINKER_API_USAGE	是否在生成的Xcode方案的诊断部分中启用动态链接器API使用。
CMAKE_XCODE_SCHEME_ENABLE_GPU_API_VALIDATION	生成的Xcode方案的“选项”部分中的Metal:neneneba API验证的属性值。
CMAKE_XCODE_SCHEME_ENABLE_GPU_FRAME_CAPTURE_MODE	生成的Xcode方案的“选项”部分中GPU帧捕获的属性值。示例值为 Metal 和Disabled
CMAKE_XCODE_SCHEME_ENABLE_GPU_SHADER_VALIDATION	生成的Xcode方案的“选项”部分中 Metal: Shader Validation的属性值。
CMAKE_XCODE_SCHEME_ENVIRONMENT	指定应添加到生成的Xcode方案的Arguments部分的环境变量。 如果设置为环境变量和MYVAR=值形式的值的列表，则这些环境变量将添加到方案中。
CMAKE_XCODE_SCHEME_GUARD_MALLOC	是否在生成的Xcode方案的Diagnostics部分启用Guard Malloc。 此变量初始化所有目标上的XCODE_SCHEME_GUARD_MALLOC属性。
CMAKE_XCODE_SCHEME_LAUNCH_CONFIGURATION	设置生成配置以运行目标。 此变量初始化所有目标上的XCODE_SCHEME_LAUNCH_CONFIGURATION属性。
CMAKE_XCODE_SCHEME_LAUNCH_MODE	生成的Xcode方案的“信息”部分中Launch的属性值。 此变量初始化所有目标上的XCODE_SCHEME_LAUNCH_MODE属性。
CMAKE_XCODE_SCHEME_MAIN_THREAD_CHECKER_STOP	是否在生成的Xcode方案的“诊断”部分中启用“主线程检测器”选项“在出现问题时暂停”。 此变量初始化所有目标上的XCODE_SCHEME_MAIN_THRAD_CHECKER_STOP属性。
CMAKE_XCODE_SCHEME_MALLOC_GUARD_EDGES	是否在生成的Xcode方案的Diagnostics部分启用Malloc Guard Edges。
CMAKE_XCODE_SCHEME_MALLOC_SCRIBBLE	是否在生成的Xcode方案的诊断部分启用Malloc Scribble。
CMAKE_XCODE_SCHEME_MALLOC_STACK	是否在生成的Xcode方案的Diagnostics部分启用Malloc Stack。
CMAKE_XCODE_SCHEME_THREAD_SANITIZER	是否在生成的Xcode方案的Diagnostics部分启用Thread Sanitizer。
CMAKE_XCODE_SCHEME_THREAD_SANITIZER_STOP	是否启用Thread Sanitizer-在生成的Xcode方案的Diagnostics部分中的问题上暂停。
CMAKE_XCODE_SCHEME_UNDEFINED_BEHAVIOUR_SANITIZER_STOP	是否在生成的Xcode方案的Diagnostics部分中启用Undefined Behavior Sanitizer选项Pause on issues。
CMAKE_XCODE_SCHEME_WORKING_DIRECTORY	在生成的Xcode方案中指定运行和配置文件操作的工作目录。
CMAKE_XCODE_SCHEME_ZOMBIE_OBJECTS	是否在生成的Xcode方案的Diagnostics部分启用Zombie Objects。
CMAKE_XCODE_XCCONFIG	如果设置，Xcode生成器将指定的文件注册为全局XCConfig文件。有关目标级别XCConfig文件，请参阅XCODE_XCConfig目标属性。
_ROOT	对find_package（）的调用将在_ROOT CMake变量指定的前缀中进行搜索，其中<PackageName]是给find_packaging（）调用的（保留大小写）名称，_ROOT是文字。例如，find_package（Foo）将搜索Foo_ROOT CMake变量中指定的前缀（如果已设置）。