环境变量

这些是少数可用于配置某些 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 conf，以强制 Conan 在请求任何交互式提示时失败，从而避免 CI 进程卡住。

终端颜色变量

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

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

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

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

日志记录

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