尧图网页设计 
构建工具开发工具CLI【免费下载链接】CMakeMirror of CMake upstream repository项目地址https://gitcode.com/gh_mirrors/cm/CMake点击查看免费下载CLICOLOR 是 CMake 3.21 起引入的终端颜色控制环境变量用于告诉 CMake 命令行工具在连接到终端时是否输出彩色消息。本文以 Help/envvar/CLICOLOR.rst 为骨架结合 CMake 源码中的实际实现Source/cmStdIoTerminal.cxx 与 Source/cmStdIoStream.cxx完整讲解 CLICOLOR 的取值语义、与其他颜色控制变量的优先级关系、底层判定逻辑以及在实际构建和 CI 场景中的用法帮助你彻底掌控 CMake 输出颜色的开关。一、CLICOLOR 是什么CLICOLOR 是一个 CMake环境变量Environment Variable其初始值取自调用进程的环境。按照 Help/envvar/include/ENV_VAR.rst 的通用说明它与普通 CMake 变量不同不需要在 CMakeLists.txt 中set()而是直接继承自 shell 或启动 CMake 的进程。它的语义非常简洁将 CLICOLOR 设置为0可以告诉命令行工具即使连接到了终端也不要打印彩色消息。这一约定并非 CMake 独创而是命令行工具圈的通用惯例common convention许多终端程序都遵守同一套规则——CLICOLOR0表示禁用颜色CLICOLOR_FORCE表示强制启用颜色。CMake 3.21 起遵循该惯例将 CMake 自身的命令行工具输出如 configure 时的诊断信息、警告、错误消息纳入这一套统一管控。二、三个颜色变量的职责与优先级CLICOLOR 并不是孤立的。CMake 同时支持三个相关环境变量文档中明确给出了优先级关系。以下是三个变量的对照总览环境变量引入版本生效值作用NO_COLOR4.1非空且不等于0即使连接到终端也禁用彩色消息CLICOLOR_FORCE3.5非空且不等于0即使未连接到终端也强制启用彩色消息CLICOLOR3.21恰好为0连接到终端时禁用彩色消息优先级规则由高到低NO_COLOR一旦激活优先于CLICOLOR_FORCE和CLICOLOR两者否则CLICOLOR_FORCE一旦激活优先于CLICOLOR只有前两者都未激活时CLICOLOR的取值才生效。也就是说三者呈现强制禁用 强制启用 默认禁用的覆盖关系。更精确地说CLICOLOR0只有在NO_COLOR未激活且CLICOLOR_FORCE未激活时才会真正让 CMake 关闭颜色。相关文档可分别参见 Help/envvar/NO_COLOR.rst 和 Help/envvar/CLICOLOR_FORCE.rst。三、源码实现优先级判定究竟如何落地上述优先级并非只写在文档里在 CMake 源码中有完全对应的实现。CMake 在 Source/cmStdIoTerminal.cxx 中用一个立即执行的 lambda 表达式TermEnv解析这些环境变量判定结果以cm::optionalTermKind的形式缓存只在进程启动时计算一次auto const TermEnv []() - cm::optionalTermKind { /* Disable color according to https://bixense.com/clicolors/ convention. */ if (cm::optionalstd::string noColor cmSystemTools::GetEnvVar(NO_COLOR)) { if (!noColor-empty() *noColor ! 0_s) { return TermKind::None; } } /* Force color according to https://bixense.com/clicolors/ convention. */ if (cm::optionalstd::string cliColorForce cmSystemTools::GetEnvVar(CLICOLOR_FORCE)) { if (!cliColorForce-empty() *cliColorForce ! 0_s) { return TermKind::VT100; } } /* Disable color according to https://bixense.com/clicolors/ convention. */ if (cm::optionalstd::string cliColor cmSystemTools::GetEnvVar(CLICOLOR)) { if (*cliColor 0_s) { return TermKind::None; } } /* GNU make 4.1 may tell us that its output is destined for a TTY. */ if (cm::optionalstd::string makeTermOut cmSystemTools::GetEnvVar(MAKE_TERMOUT)) { if (!makeTermOut-empty()) { return TermKind::VT100; } } return cm::nullopt; }();从源码结构可以明确推断出以下实现事实判定顺序严格固定NO_COLOR→CLICOLOR_FORCE→CLICOLOR→MAKE_TERMOUT先命中者直接短路返回这构成了文档所述优先级关系的底层保障。取值判定细节NO_COLOR和CLICOLOR_FORCE要求非空且不等于0才激活而CLICOLOR则只认恰好等于0才禁用——任何其他值包括空值都不会关闭颜色这与CLICOLOR0的语义完全吻合。MAKE_TERMOUT的补充如果以上三个变量都未命中CMake 还会检查 GNU make 4.1 设置的MAKE_TERMOUT环境变量非空即认为输出面向终端强制以 VT100 模式输出颜色。这也是CLICOLOR 未设置时彩色输出仍然可能出现的一个重要来源。结果是optional当所有变量都未激活时返回cm::nullopt表示交给终端类型自动判定此时由 Source/cmStdIoTerminal.cxx 的Print函数回退到os.Kind()获取的终端能力。四、终端能力判定CLICOLOR 之外的底层逻辑当CLICOLOR等变量未介入时CMake 输出是否彩色取决于输出流本身的TermKind这一判定在 Source/cmStdIoStream.cxx 的流构造函数中完成类 Unix 平台CMake 使用isatty()判断文件描述符是否指向终端同时检查TERM环境变量是否为已知的 VT100 兼容终端名如xterm系列、screen、tmux等两者都满足才将输出流标记为TermKind::VT100。Windows 平台通过GetConsoleMode探测控制台句柄若成功启用ENABLE_VIRTUAL_TERMINAL_PROCESSING虚拟终端处理则视为TermKind::VT100否则回退为通过SetConsoleTextAttribute直接设置控制台属性的TermKind::Console模式。颜色属性的具体实现位于 Source/cmStdIoTerminal.hTermAttr枚举定义了 19 种文本属性Normal、前景 8 色、背景 8 色及加粗并映射为 VT100 转义序列如\33[31m红色、\33[32m绿色见 Source/cmStdIoTerminal.cxx。由此可见CLICOLOR0的实际效果是在Print输出路径上TermEnv直接返回TermKind::None从而跳过SetVT100Attrs转义序列的写入Source/cmStdIoTerminal.cxx最终输出纯文本。五、实践用法1. 临时禁用 CMake 命令行的彩色输出# 单条命令 CLICOLOR0 cmake -S . -B build # 或导出到当前 shell 会话 export CLICOLOR0 cmake --build build设置后CMake 的 configure 诊断信息、警告、错误消息等命令行输出将不再包含 ANSI 颜色转义序列。2. 强制启用颜色管道/重定向场景当 CMake 输出被重定向到文件或通过管道传给其他工具时默认不再着色若希望保留颜色以便人工查看日志文件可以使用 CLICOLOR_FORCECLICOLOR_FORCE1 cmake -S . -B build configure.log3. 强制禁用颜色的最稳妥做法在 CI、日志采集或文本处理场景中若同时存在其他工具设置的CLICOLOR_FORCE单独设置CLICOLOR0可能无效——因为CLICOLOR_FORCE优先级更高。此时应使用最高优先级的NO_COLORNO_COLOR1 CLICOLOR0 cmake -S . -B build4. 验证是否生效CMake 提供的 Source/cmCTest.cxx 中的判定方式表明CTest 同样复用cm::StdIo::Out().Kind()来判断输出流是否为 VT100 终端。你可以通过对比同一命令在设置变量前后的输出来验证在支持彩色的终端中CLICOLOR0 cmake -S . -B build应输出不带转义码的纯文本例如重定向到文件后用cat -v build.log | grep \^\\[检查是否残留^[开头的 ANSI 序列。六、与生成系统的颜色控制CMAKE_COLOR_DIAGNOSTICS需要特别区分的是CLICOLOR 只影响 CMake 自身命令行工具的运行时输出。对于生成出来的构建系统如 Makefile 或 Ninja 构建过程中的编译诊断颜色则要使用CMAKE_COLOR_DIAGNOSTICS变量控制详见 Help/variable/CMAKE_COLOR_DIAGNOSTICS.rst。该变量有三种状态控制面更广未定义Makefile 生成器将CMAKE_COLOR_MAKEFILE初始化为ONGNU/Clang 编译器不带颜色诊断参数ONMakefile 生成器默认产生彩色构建消息可通过CMAKE_COLOR_MAKEFILEOFF显式关闭GNU/Clang 编译器追加-fcolor-diagnosticsOFFMakefile 生成器默认不产生彩色构建消息可通过CMAKE_COLOR_MAKEFILEON显式开启GNU/Clang 编译器追加-fno-color-diagnostics。此外如果设置了CMAKE_COLOR_DIAGNOSTICS对应的同名环境变量其值也会被采用。因此一份完整的关闭所有颜色的配置通常需要同时考虑 CLI 层CLICOLOR0与构建系统层-DCMAKE_COLOR_DIAGNOSTICSOFF。七、小结场景推荐设置仅在交互终端禁用 CMake 命令行颜色export CLICOLOR0重定向/管道时强制保留颜色CLICOLOR_FORCE1无条件禁用命令行颜色最高优先级NO_COLOR1关闭生成系统的编译诊断颜色cmake -DCMAKE_COLOR_DIAGNOSTICSOFFCLICOLOR是 CMake 融入命令行工具通用颜色约定的一环它以0为唯一禁用信号并置于NO_COLOR、CLICOLOR_FORCE之后作为兜底。理解其取值语义与 Source/cmStdIoTerminal.cxx 中体现的优先级实现再配合CMAKE_COLOR_DIAGNOSTICS区分CLI 层与构建系统层的颜色控制即可在本地开发、日志采集、CI 流水线等不同环境中精确掌控 CMake 的彩色输出行为。赞分享构建工具开发工具CLI【免费下载链接】CMakeMirror of CMake upstream repository项目地址https://gitcode.com/gh_mirrors/cm/CMake点击查看免费下载相关推荐如何完整导出QQ空间历史说说从零跑通 GetQzonehistory 的新手指南如何完整导出QQ空间历史说说从零跑通 GetQzonehistory 的新手指南 想找一条三年前写的说说QQ空间网页版只能翻到当前可见的页面更早的只能去消网页爬虫数据分析ZeroTermux 终端色彩定制指南dircolors 命令与 LS_COLORS 环境变量完全解析ZeroTermux 终端色彩定制指南dircolors 命令与 LS_COLORS 环境变量完全解析 导读 在 ZeroTermux 这类运行于 Andro移动开发开发工具终极todo.txt-cli色彩配置指南美化命令行输出的完整教程终极todo.txt cli色彩配置指南美化命令行输出的完整教程 todo.txt cli是一款简单且可扩展的命令行工具用于管理你的todo.txt文件。通开发工具上一篇3分钟上手哔哩下载姬绿色版B站视频下载的终极解决方案下一篇3秒解锁百度网盘资源baidupankey提取码智能获取工具完整教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CMake 的 CLICOLOR 环境变量：完整控制命令行彩色输出指南
构建工具开发工具CLI【免费下载链接】CMakeMirror of CMake upstream repository项目地址https://gitcode.com/gh_mirrors/cm/CMake点击查看免费下载CLICOLOR 是 CMake 3.21 起引入的终端颜色控制环境变量用于告诉 CMake 命令行工具在连接到终端时是否输出彩色消息。本文以 Help/envvar/CLICOLOR.rst 为骨架结合 CMake 源码中的实际实现Source/cmStdIoTerminal.cxx 与 Source/cmStdIoStream.cxx完整讲解 CLICOLOR 的取值语义、与其他颜色控制变量的优先级关系、底层判定逻辑以及在实际构建和 CI 场景中的用法帮助你彻底掌控 CMake 输出颜色的开关。一、CLICOLOR 是什么CLICOLOR 是一个 CMake环境变量Environment Variable其初始值取自调用进程的环境。按照 Help/envvar/include/ENV_VAR.rst 的通用说明它与普通 CMake 变量不同不需要在 CMakeLists.txt 中set()而是直接继承自 shell 或启动 CMake 的进程。它的语义非常简洁将 CLICOLOR 设置为0可以告诉命令行工具即使连接到了终端也不要打印彩色消息。这一约定并非 CMake 独创而是命令行工具圈的通用惯例common convention许多终端程序都遵守同一套规则——CLICOLOR0表示禁用颜色CLICOLOR_FORCE表示强制启用颜色。CMake 3.21 起遵循该惯例将 CMake 自身的命令行工具输出如 configure 时的诊断信息、警告、错误消息纳入这一套统一管控。二、三个颜色变量的职责与优先级CLICOLOR 并不是孤立的。CMake 同时支持三个相关环境变量文档中明确给出了优先级关系。以下是三个变量的对照总览环境变量引入版本生效值作用NO_COLOR4.1非空且不等于0即使连接到终端也禁用彩色消息CLICOLOR_FORCE3.5非空且不等于0即使未连接到终端也强制启用彩色消息CLICOLOR3.21恰好为0连接到终端时禁用彩色消息优先级规则由高到低NO_COLOR一旦激活优先于CLICOLOR_FORCE和CLICOLOR两者否则CLICOLOR_FORCE一旦激活优先于CLICOLOR只有前两者都未激活时CLICOLOR的取值才生效。也就是说三者呈现强制禁用 强制启用 默认禁用的覆盖关系。更精确地说CLICOLOR0只有在NO_COLOR未激活且CLICOLOR_FORCE未激活时才会真正让 CMake 关闭颜色。相关文档可分别参见 Help/envvar/NO_COLOR.rst 和 Help/envvar/CLICOLOR_FORCE.rst。三、源码实现优先级判定究竟如何落地上述优先级并非只写在文档里在 CMake 源码中有完全对应的实现。CMake 在 Source/cmStdIoTerminal.cxx 中用一个立即执行的 lambda 表达式TermEnv解析这些环境变量判定结果以cm::optionalTermKind的形式缓存只在进程启动时计算一次auto const TermEnv []() - cm::optionalTermKind { /* Disable color according to https://bixense.com/clicolors/ convention. */ if (cm::optionalstd::string noColor cmSystemTools::GetEnvVar(NO_COLOR)) { if (!noColor-empty() *noColor ! 0_s) { return TermKind::None; } } /* Force color according to https://bixense.com/clicolors/ convention. */ if (cm::optionalstd::string cliColorForce cmSystemTools::GetEnvVar(CLICOLOR_FORCE)) { if (!cliColorForce-empty() *cliColorForce ! 0_s) { return TermKind::VT100; } } /* Disable color according to https://bixense.com/clicolors/ convention. */ if (cm::optionalstd::string cliColor cmSystemTools::GetEnvVar(CLICOLOR)) { if (*cliColor 0_s) { return TermKind::None; } } /* GNU make 4.1 may tell us that its output is destined for a TTY. */ if (cm::optionalstd::string makeTermOut cmSystemTools::GetEnvVar(MAKE_TERMOUT)) { if (!makeTermOut-empty()) { return TermKind::VT100; } } return cm::nullopt; }();从源码结构可以明确推断出以下实现事实判定顺序严格固定NO_COLOR→CLICOLOR_FORCE→CLICOLOR→MAKE_TERMOUT先命中者直接短路返回这构成了文档所述优先级关系的底层保障。取值判定细节NO_COLOR和CLICOLOR_FORCE要求非空且不等于0才激活而CLICOLOR则只认恰好等于0才禁用——任何其他值包括空值都不会关闭颜色这与CLICOLOR0的语义完全吻合。MAKE_TERMOUT的补充如果以上三个变量都未命中CMake 还会检查 GNU make 4.1 设置的MAKE_TERMOUT环境变量非空即认为输出面向终端强制以 VT100 模式输出颜色。这也是CLICOLOR 未设置时彩色输出仍然可能出现的一个重要来源。结果是optional当所有变量都未激活时返回cm::nullopt表示交给终端类型自动判定此时由 Source/cmStdIoTerminal.cxx 的Print函数回退到os.Kind()获取的终端能力。四、终端能力判定CLICOLOR 之外的底层逻辑当CLICOLOR等变量未介入时CMake 输出是否彩色取决于输出流本身的TermKind这一判定在 Source/cmStdIoStream.cxx 的流构造函数中完成类 Unix 平台CMake 使用isatty()判断文件描述符是否指向终端同时检查TERM环境变量是否为已知的 VT100 兼容终端名如xterm系列、screen、tmux等两者都满足才将输出流标记为TermKind::VT100。Windows 平台通过GetConsoleMode探测控制台句柄若成功启用ENABLE_VIRTUAL_TERMINAL_PROCESSING虚拟终端处理则视为TermKind::VT100否则回退为通过SetConsoleTextAttribute直接设置控制台属性的TermKind::Console模式。颜色属性的具体实现位于 Source/cmStdIoTerminal.hTermAttr枚举定义了 19 种文本属性Normal、前景 8 色、背景 8 色及加粗并映射为 VT100 转义序列如\33[31m红色、\33[32m绿色见 Source/cmStdIoTerminal.cxx。由此可见CLICOLOR0的实际效果是在Print输出路径上TermEnv直接返回TermKind::None从而跳过SetVT100Attrs转义序列的写入Source/cmStdIoTerminal.cxx最终输出纯文本。五、实践用法1. 临时禁用 CMake 命令行的彩色输出# 单条命令 CLICOLOR0 cmake -S . -B build # 或导出到当前 shell 会话 export CLICOLOR0 cmake --build build设置后CMake 的 configure 诊断信息、警告、错误消息等命令行输出将不再包含 ANSI 颜色转义序列。2. 强制启用颜色管道/重定向场景当 CMake 输出被重定向到文件或通过管道传给其他工具时默认不再着色若希望保留颜色以便人工查看日志文件可以使用 CLICOLOR_FORCECLICOLOR_FORCE1 cmake -S . -B build configure.log3. 强制禁用颜色的最稳妥做法在 CI、日志采集或文本处理场景中若同时存在其他工具设置的CLICOLOR_FORCE单独设置CLICOLOR0可能无效——因为CLICOLOR_FORCE优先级更高。此时应使用最高优先级的NO_COLORNO_COLOR1 CLICOLOR0 cmake -S . -B build4. 验证是否生效CMake 提供的 Source/cmCTest.cxx 中的判定方式表明CTest 同样复用cm::StdIo::Out().Kind()来判断输出流是否为 VT100 终端。你可以通过对比同一命令在设置变量前后的输出来验证在支持彩色的终端中CLICOLOR0 cmake -S . -B build应输出不带转义码的纯文本例如重定向到文件后用cat -v build.log | grep \^\\[检查是否残留^[开头的 ANSI 序列。六、与生成系统的颜色控制CMAKE_COLOR_DIAGNOSTICS需要特别区分的是CLICOLOR 只影响 CMake 自身命令行工具的运行时输出。对于生成出来的构建系统如 Makefile 或 Ninja 构建过程中的编译诊断颜色则要使用CMAKE_COLOR_DIAGNOSTICS变量控制详见 Help/variable/CMAKE_COLOR_DIAGNOSTICS.rst。该变量有三种状态控制面更广未定义Makefile 生成器将CMAKE_COLOR_MAKEFILE初始化为ONGNU/Clang 编译器不带颜色诊断参数ONMakefile 生成器默认产生彩色构建消息可通过CMAKE_COLOR_MAKEFILEOFF显式关闭GNU/Clang 编译器追加-fcolor-diagnosticsOFFMakefile 生成器默认不产生彩色构建消息可通过CMAKE_COLOR_MAKEFILEON显式开启GNU/Clang 编译器追加-fno-color-diagnostics。此外如果设置了CMAKE_COLOR_DIAGNOSTICS对应的同名环境变量其值也会被采用。因此一份完整的关闭所有颜色的配置通常需要同时考虑 CLI 层CLICOLOR0与构建系统层-DCMAKE_COLOR_DIAGNOSTICSOFF。七、小结场景推荐设置仅在交互终端禁用 CMake 命令行颜色export CLICOLOR0重定向/管道时强制保留颜色CLICOLOR_FORCE1无条件禁用命令行颜色最高优先级NO_COLOR1关闭生成系统的编译诊断颜色cmake -DCMAKE_COLOR_DIAGNOSTICSOFFCLICOLOR是 CMake 融入命令行工具通用颜色约定的一环它以0为唯一禁用信号并置于NO_COLOR、CLICOLOR_FORCE之后作为兜底。理解其取值语义与 Source/cmStdIoTerminal.cxx 中体现的优先级实现再配合CMAKE_COLOR_DIAGNOSTICS区分CLI 层与构建系统层的颜色控制即可在本地开发、日志采集、CI 流水线等不同环境中精确掌控 CMake 的彩色输出行为。赞分享构建工具开发工具CLI【免费下载链接】CMakeMirror of CMake upstream repository项目地址https://gitcode.com/gh_mirrors/cm/CMake点击查看免费下载相关推荐如何完整导出QQ空间历史说说从零跑通 GetQzonehistory 的新手指南如何完整导出QQ空间历史说说从零跑通 GetQzonehistory 的新手指南 想找一条三年前写的说说QQ空间网页版只能翻到当前可见的页面更早的只能去消网页爬虫数据分析ZeroTermux 终端色彩定制指南dircolors 命令与 LS_COLORS 环境变量完全解析ZeroTermux 终端色彩定制指南dircolors 命令与 LS_COLORS 环境变量完全解析 导读 在 ZeroTermux 这类运行于 Andro移动开发开发工具终极todo.txt-cli色彩配置指南美化命令行输出的完整教程终极todo.txt cli色彩配置指南美化命令行输出的完整教程 todo.txt cli是一款简单且可扩展的命令行工具用于管理你的todo.txt文件。通开发工具上一篇3分钟上手哔哩下载姬绿色版B站视频下载的终极解决方案下一篇3秒解锁百度网盘资源baidupankey提取码智能获取工具完整教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考