环境变量¶

只有很少的环境变量可以用来配置一些 Conan 的行为。这些变量是例外情况，对于自定义和配置控制，Conan 使用 global.conf 配置文件和 profile [conf] 部分

CONAN_HOME¶

此变量控制 Conan 主文件夹的位置。默认情况下，如果未定义，它将为 <username>/.conan2。

注意

请记住，Conan 主文件夹中包含的 Conan 包缓存不是并发的。不同的并行任务（例如 CI 中可能发生的那些任务）需要使用单独的缓存，而定义 CONAN_HOME 就是实现此目的的方法。

CONAN_DEFAULT_PROFILE¶

默认配置文件将是 Conan 缓存中的 "default" 文件。此环境变量允许定义不同的默认名称。还有 conf 项目 core:default_profile 和 core:default_build_profile 用于定义此类默认配置文件名称，此环境变量仅在 conf 不够时使用。

远程登录变量¶

CONAN_LOGIN_USERNAME、CONAN_LOGIN_USERNAME_{REMOTE_NAME} 定义给定远程的登录用户名。 CONAN_PASSWORD、CONAN_PASSWORD_{REMOTE_NAME} 定义给定远程的登录密码。

这些环境变量只是 Conan CLI 请求时交互式输入用户名或密码的替代品。除非远程服务器引发身份验证挑战，否则它们不会执行任何身份验证。这意味着对于某些配置为允许匿名使用的远程服务器，这些变量将不会被使用，并且用户将保持未经身份验证的用户状态，除非首先执行 conan remote login 或 conan remote auth。

当 Conan CLI 即将询问用户远程密码时，它将首先检查变量 CONAN_LOGIN_USERNAME_{REMOTE_NAME} 或 CONAN_PASSWORD_{REMOTE_NAME}，如果变量未声明，Conan 将尝试分别使用变量 CONAN_LOGIN_USERNAME 和 CONAN_PASSWORD，如果变量也未声明，Conan 将请求用户输入密码或失败。

远程名称转换为全大写。如果远程名称包含“-”，则必须在变量名称中将其替换为“_”。

注意

这些变量对于无人值守执行（如 CI 服务器或自动化任务）以及作为 CI 密钥很有用。
不建议在开发人员机器上使用这些变量。
请记住，除非远程服务器请求，否则这些变量不会执行身份验证。
可以在 global.conf 中定义 core:non_interactive 配置，以强制 Conan 在请求任何交互式提示时失败，以避免 CI 进程卡住。

终端颜色变量¶

Conan 的默认行为是尝试自动检测输出。如果输出重定向到文件或其他不支持 tty 的内容，则无法打印颜色，它将禁用彩色输出。对于常规终端，它将尝试执行彩色输出，除非以下某些内容更改该行为。

CLICOLOR_FORCE 强制生成终端颜色转义字符，无论终端的自动检测结果如何。
NO_COLOR 禁用颜色转义字符的生成。如果激活了 CLICOLOR_FORCE，则此选项将被忽略。
CONAN_COLOR_DARK 将为白色/浅色背景终端反转配色方案（默认情况下假设为深色背景）。

日志记录¶

环境变量 CONAN_LOG_LEVEL 可以定义 Conan 命令行详细程度，与 -v 命令行参数相同，具有相同的值（error、verbose 等）。如果同时存在，它也优先于命令行参数的值。这对于在 CI 管道、自动化等中临时更改日志级别很有用，而无需修改命令行参数。