安装¶

Conan 可以在多种操作系统上安装。它在 Windows、Linux（不同发行版）、macOS 上得到了广泛的使用和测试，并且在 FreeBSD 和 Solaris SunOS 中也得到了积极的使用。据报道，它还可以用于其他一些操作系统。

安装 Conan 有多种方式

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

使用 pip 安装（推荐）¶

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

安装 Conan

$ pip install conan

重要

请仔细阅读

确保您的 pip 安装与您的 Python (>= 3.7) 版本匹配。
在 Linux 上，您可能需要 sudo 权限才能全局安装 Conan。
我们强烈建议为所有与 Python 相关的操作使用 虚拟环境（virtualenvwrapper 效果很好）（请参阅 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）。如果不使用 虚拟环境，conan 的依赖项可能会与先前已有的依赖项冲突，特别是如果您将 Python 用于其他目的。
在 macOS 上，尤其是较新版本可能具有 系统完整性保护（System Integrity Protection），pip 可能会失败。尝试使用虚拟环境，或使用 $ pip install --user conan 安装到 Python 用户安装目录。
某些 Linux 发行版，例如 Linux Mint，在安装后需要重启（重启终端，或注销/系统重启如果不够），以便 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 下载页面有许多适用于 macOS Homebrew、Debian、Windows、Arch Linux 的现有安装程序，这些安装程序不需要安装 Python。

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

警告

如果您使用的是 macOS，请注意 Gatekeeper 功能，它可能会将直接通过网页浏览器下载的压缩二进制文件进行隔离。要避免此问题，请使用 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。

从源代码安装¶

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

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

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

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

$ conan

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