安装¶

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

有不同的方法可以安装 Conan

首选且**强烈推荐的 Conan 安装方式**是通过 PyPI（Python 包索引），使用 pip 命令。
使用系统安装程序，或创建您自己的独立 Conan 可执行文件，以避免系统中需要 Python。
从源代码运行 Conan。

使用 pip 安装（推荐）¶

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

安装 Conan

$ pip install conan

重要

请仔细阅读

确保您的**pip**安装版本与您的**Python (>= 3.6)**版本匹配。
在**Linux**上，您可能需要**sudo**权限才能全局安装 Conan。
我们强烈建议将**virtualenvs**（virtualenvwrapper 非常有效）用于与 Python 相关的所有操作。（查看 https://virtualenvwrapper.readthedocs.io/en/stable/，或在 Windows 上查看 https://pypi.ac.cn/project/virtualenvwrapper-win/）使用 Python 3，内置模块 venv 也可用于替代（查看 https://docs.pythonlang.cn/3/library/venv.html）。如果不使用**virtualenv**，conan 的依赖项可能会与先前存在的依赖项发生冲突，尤其是在您将 Python 用于其他目的时。
在**OSX**上，特别是可能具有**系统完整性保护**的最新版本，pip 可能会失败。尝试使用 virtualenvs，或使用 $ pip install --user conan 将其安装到 Python 用户安装目录。
某些 Linux 发行版，例如 Linux Mint，在安装后需要重新启动（shell 重新启动或注销/系统重新启动，如果不够的话），以便在路径中找到 Conan。

使用 pip 已知的安装问题¶

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

$ source ~/.profile

更新¶

如果通过 pip 安装，可以使用以下命令更新 Conan 版本：

$ pip install conan --upgrade  # Might need sudo or --user

升级不应影响已安装的包或缓存信息。如果缓存以某种方式变得不一致，您可能希望通过删除它 (<userhome>/.conan2) 来删除其内容。

使用 pipx 安装¶

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

error: externally-managed-environment

x This environment is externally managed
    To install Python packages system-wide, try apt install
    python3-xyz, where xyz is the package you are trying to
    install.
...

这是因为某些现代 Linux 发行版已开始将其 Python 安装标记为“外部管理”，这意味着系统包管理器负责管理 Python 包。全局或甚至在用户空间安装包可能会干扰系统操作并可能破坏系统工具（查看 PEP-668 以获取更多详细信息）。

对于这些情况，建议使用 pipx 安装 Conan。 pipx 为每个 Python 应用程序创建一个虚拟环境，确保依赖项不会冲突。这样做的好处是它将 Conan 及其依赖项与系统 Python 隔离开，避免与系统包发生潜在冲突，同时为 Conan 提供一个干净的运行环境。

要使用 pipx 安装 Conan

确保 pipx 已安装在您的系统上。如果没有，请查看 pipx 文档中的安装指南。对于基于 Debian 的发行版，您可以使用系统包管理器安装 pipx

$ apt-get install pipx
$ pipx ensurepath

（注意：包名称可能因发行版而异）

重新启动终端，然后使用 pipx 安装 Conan

$ pipx install conan

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

使用系统安装程序或创建独立的可执行文件¶

在 Conan 下载中将会有许多现有的安装程序，适用于 OSX Brew、Debian、Windows、Linux Arch，这些安装程序不需要先安装 Python。

我们还分发了 Conan 二进制文件，适用于 Windows、Linux 和 macOS，压缩在您可以解压缩到系统并直接运行的文件中。

警告

如果您使用的是**macOS**，请注意 Gatekeeper 功能，如果直接使用网络浏览器下载压缩二进制文件，它可能会将其隔离。要避免此问题，请使用 curl、wget 或类似工具下载它们。

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

您可以使用以下命令执行此操作：

$ git clone https://github.com/conan-io/conan conan_src
$ cd conan_src
$ git checkout develop2 # or to the specific tag you want to
$ pip install -e .
$ python pyinstaller.py

重要的是要先使用 pip install -e . 安装依赖项和项目，这将项目配置为“可编辑”，即从当前源文件夹运行。创建可执行文件后，可以使用 pip 卸载它。

这必须在将使用可执行文件的同一平台上运行，pyinstaller 不会进行交叉编译。生成的可执行文件可以简单地复制并放置在正在运行的机器的系统 PATH 中，以便能够运行 Conan。

从源代码安装¶

您可以直接从源代码运行 Conan。首先，您需要安装 Python 和 pip。

克隆（或下载并解压缩）git 存储库并安装它。

Conan 2 仍处于测试阶段，因此您必须检查存储库的 develop2 分支

# clone folder name matters, to avoid imports issues
$ git clone https://github.com/conan-io/conan.git conan_src
$ cd conan_src
$ git fetch --all
$ git checkout -b develop2 origin/develop2
$ python -m pip install -e .

并测试您的 conan 安装

$ conan

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