环境变量

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

CONAN_HOME

此变量控制 Conan 主文件夹的位置。默认情况下，如果未定义，则为 <用户名>/.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_{远程名称} 定义给定远程的登录用户名。CONAN_PASSWORD, CONAN_PASSWORD_{远程名称} 定义给定远程的登录密码。

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

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

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

注意

  • 这些变量对于无人值守的执行（如 CI 服务器或自动化任务）作为 CI 机密非常有用

  • 不建议在开发人员机器上使用这些变量。

  • 请注意，除非远程服务器请求，否则这些变量不执行身份验证。

  • 可以在 global.conf 中定义 core:non_interactive conf，以强制 Conan 在请求任何交互式提示时失败，以避免 CI 进程卡住。

终端颜色变量

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

  • CLICOLOR_FORCE 强制生成终端颜色转义字符，无论终端的自动检测结果如何。

  • NO_COLOR 禁用颜色转义字符的生成。如果激活了 CLICOLOR_FORCE，则将忽略此项。

  • CONAN_COLOR_DARK 将反转白色/浅色背景终端的配色方案（默认假设为深色背景）。

日志记录

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