环境变量

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

CONAN_HOME

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

注意

请注意，Conan 包缓存（包含在 Conan home 中）不是并发的。不同的并行任务（例如 CI 中可能发生的任务）需要使用单独的缓存，定义 CONAN_HOME 是实现此目的的方法。

CONAN_DEFAULT_PROFILE

默认 profile 将是 Conan 缓存中的 "default" 文件。此环境变量允许定义不同的默认名称。还有 conf 项 core:default_profile 和 core:default_build_profile 用于定义此类默认 profile 名称，只有当 conf 不够用时才应使用此 env-var。

远程登录变量

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 conf，以强制 Conan 在请求任何交互式提示时失败，以避免 CI 进程卡住。

终端颜色变量

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

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

  • NO_COLOR 禁用颜色转义字符的生成。如果 CLICOLOR_FORCE 被激活，这将​​被忽略。

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

日志记录

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