包命名约定#
为了方便沟通和文档编写,conda 遵循以下列出的包命名约定
- 包名称#
包的名称,不涉及特定版本。Conda 包名称已标准化,并且可能仅包含小写字母字符、数字、下划线、连字符或点。在用法文档中,这些被称为
package_name
。- 包版本#
版本号或字符串,通常类似于
X.Y
或X.Y.Z
,但也可能采用其他形式。- 构建字符串#
一个任意字符串,用于标识 conda 包的特定构建版本。它可能包含暗示性的助记符,但这些可能会发生变化,您不应依赖它或尝试解析它以获取任何特定信息。
- 规范名称#
包名称、版本和构建字符串用连字符连接在一起:name-version-buildstring。在用法文档中,这些被称为
canonical_name
。- 文件名#
Conda 包文件名是规范名称,加上后缀
.tar.bz2
或.conda
。
下图比较了规范名称和文件名

Conda 包命名#
Conda 同时支持 .conda
和 .tar.bz2
包扩展名。.conda
格式(自 25.1 版本以来的默认格式)通常比 .tar.bz2
包更小更高效。阅读我们的 博客文章 了解更多信息。
构建字符串是在构建包时创建的。影响它的因素包括命令行或来自 conda_build_config.yaml
的配置中指定的变体,以及配方中的构建编号。如果没有变体,则构建字符串是配方中指定的构建编号。
包规范#
包名称以及包版本(可以是部分的或缺失的),用等号连接。
示例
python=2.7.3
python=2.7
python
在用法文档中,这些被称为 package_spec
。