环境变量

有很少的环境变量可用于配置 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_{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 密钥。

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

  • 请记住,除非远程服务器要求,否则这些变量不会执行身份验证。

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

终端颜色变量

Conan 的默认行为是尝试自动检测输出。如果输出被重定向到文件,或者其他不支持 `tty` 的设备(无法打印颜色),它将禁用彩色输出。对于常规终端,它将尝试进行彩色输出,除非以下任一选项改变了这种行为:

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

  • `NO_COLOR` 禁用颜色转义字符的生成。如果激活了 `CLICOLOR_FORCE`,此变量将被忽略。

  • `CONAN_COLOR_DARK` 将为白色/浅色背景终端反转配色方案(默认假设为深色背景)。

日志记录

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