Conan 安装指南：四种方式全解析

原文：Conan Documentation — Release 2.29.0

Conan 可以在许多操作系统上安装。它已在 Windows、Linux（不同发行版）、macOS 上得到广泛使用和测试，并且也在 FreeBSD 和 Solaris SunOS 上被积极使用。还有一些其他操作系统上也有报告称可以工作。

安装 Conan 有不同的方式：

首选且强烈推荐的方式：从 PyPI（Python Package Index）使用 pip 命令安装。
使用系统安装程序，或创建自己的自包含 Conan 可执行文件，这样系统上就不需要 Python。
从源码运行 Conan。

2.1 使用 pip 安装（推荐）

要使用 pip 安装最新的 Conan 2 版本，您的机器上需要安装 Python >= 3.8 发行版。现代的 Python 发行版预装了 pip。但如果需要，您可以按照 pip 文档中的说明安装 pip。

安装 Conan：

$ pip install conan

重要：请仔细阅读：

确保您的 pip 安装与您的 Python（>= 3.8）版本匹配。
在 Linux 上，您可能需要 sudo 权限才能全局安装 Conan。
我们强烈建议对所有与 Python 相关的内容使用 virtualenvs。使用 Python 3 时，也可以使用内置模块 venv。
在 macOS 上，尤其是启用了系统完整性保护（SIP）的最新版本，pip 可能会失败。尝试使用 virtualenvs，或使用 $ pip install --user conan 安装到 Python 用户安装目录。
某些 Linux 发行版（如 Linux Mint）在安装后需要重启（shell 重启，或注销/重启系统），以便在路径中找到 Conan。

2.1.1 pip 的已知安装问题

当使用 pip install --user conan 安装 Conan 时，通常会创建一个新目录。但是，该目录不会自动追加到 PATH 中，因此 conan 命令无法工作。通常可以通过重启终端会话或运行以下命令来解决：

$ source ~/.profile

2.1.2 更新

如果通过 pip 安装，Conan 版本可以通过以下方式更新：

$ pip install conan --upgrade

升级不会影响已安装的包或缓存信息。如果缓存因某种原因变得不一致，您可以通过删除 <userhome>/.conan2 来清除其内容。

2.2 使用 pipx 安装

在某些情况下，尝试使用 pip 安装可能会产生以下错误：

error: externally-managed-environment
× This environment is externally managed

这是因为一些现代 Linux 发行版已将其 Python 安装标记为"外部管理"，这意味着系统的包管理器负责管理 Python 包。在这些情况下，建议使用 pipx 安装 Conan。pipx 为每个 Python 应用程序创建一个虚拟环境，确保依赖关系不会冲突。

使用 pipx 安装 Conan：

确保您的系统上安装了 pipx。如果没有，请查看 pipx 文档中的安装指南。
重启终端，然后使用 pipx 安装 Conan：

$ pipx install conan

现在您可以像平常一样使用 Conan。

2.3 使用系统安装程序或创建自包含可执行文件

Conan 下载页面中提供了一些针对 macOS Homebrew、Debian、Windows、Arch Linux 的安装程序，这些不需要 Python 安装。

我们还为 Windows、Linux 和 macOS 分发 Conan 二进制文件，这些文件以压缩文件形式提供，您可以在系统上解压缩并直接运行。

警告：如果您使用的是 macOS，请注意 Gatekeeper 功能可能会隔离通过 Web 浏览器直接下载的压缩二进制文件。为避免此问题，请使用 curl、wget 或类似工具下载。

如果您的平台没有安装程序，您可以使用仓库中的 pyinstaller.py 实用程序创建自己的 Conan 可执行文件。这个过程能够创建一个自包含的 Conan 可执行文件，其中包含所有需要的内容，包括 Python 解释器，因此系统上不需要安装 Python。

操作步骤：

$ git clone https://github.com/conan-io/conan conan_src
$ cd conan_src
$ pip install -e .
$ python pyinstaller.py

需要先使用 pip install -e . 安装依赖和项目，这将项目配置为"可编辑"模式，即从当前源码文件夹运行。创建可执行文件后，可以使用 pip 卸载。这必须在将使用可执行文件的同一平台上运行，pyinstaller 不能交叉构建。生成的可执行文件可以直接复制并放入运行机器的系统 PATH 中，以便运行 Conan。

2.4 从源码安装

您可以直接从源代码运行 Conan。首先，需要安装 Python 和 pip。然后，克隆（或下载并解压）Conan git 仓库并安装。

对于最新的开发版本，请检出仓库的 develop2 分支：

# 克隆文件夹名称很重要，以避免导入问题
$ git clone https://github.com/conan-io/conan.git conan_src
$ cd conan_src
$ python -m pip install -e .

现在通过运行以下命令测试您的 Conan 安装：

$ conan

您应该看到 Conan 命令的帮助信息。