如何列出 conda 可用的软件包版本 https://stackoverflow.com/questions/43222407/how-to-list-package-versions-available-with-conda/47556256#47556256有有用的答案，其中之一位于https://stackoverflow.com/a/47795843/257924 https://stackoverflow.com/a/47795843/257924它使用两个等号。conda search -h没有完全说明 MatchSpec 语法允许什么，并且只提供了少量示例。

比如我想看看最新版本的python下有哪些包，有一个包叫jedi。由于上述缺少 MatchSpec 语法的详细文档，我不得不通过实验和猜测来找到正确的语法。我最终得到：

$ condaw search 'jedi[build=py37*]' --json | grep '"build"' 
      "build": "py37_1",
      "build": "py37_0",
      "build": "py37_0",
      "build": "py37_0",
      "build": "py37_0",
$ 

以上--json使用选项只是为了让我可以找出哪些关键字，例如build可能是语法的一部分。

那么，MatchSpec 语法在哪里有正式且完整的文档记录，这样我就不必猜测了？我现在的结论是-h输出是唯一的。

有conda-build 文档中的一些（可能已过时）文档 https://docs.conda.io/projects/conda-build/en/latest/resources/package-spec.html#package-match-specifications。不过，我仍然认为他们的代码中的文档更清晰。可以从激活的base环境使用

python -c "from conda.models.match_spec import MatchSpec; help(MatchSpec)"

or on GitHub 存储库 https://github.com/conda/conda/blob/master/conda/models/match_spec.py.

从技术上讲，代码文档更多的是关于序列化MatchSpec对象的字符串表示形式，而不是解析字符串的另一个方向，但它涵盖了所有可能性。

匹配规范字符串

部分文档描述了类本身，但以下是类的字符串文字表示的相关部分：

规范的字符串表示一般可以表示为

(channel(/subdir):(namespace):)name(version(build))[key1=value1,key2=value2]

where ()指示可选字段。构建规则 规范的字符串表示形式是：

1. name（即“包名称”）是必需的，但其值可以是“*”。它的位置始终在键值括号之外。
2. If version是一个精确版本，它超出了键值括号，并且前面加上==. If version是一个“模糊”值 （例如。1.11.*)，它超出了键值括号.*留下并前置=。否则version是 包含在键值括号内。
3. If version是一个精确版本，并且build是一个精确值，build超出前面带有 a 的键值括号=。 否则，build位于键值括号内。build_string是一个别名build.
4. The namespace正在为未来的 conda 功能保留该位置。
5. If channel包含在内并且是一个精确值，a::之间使用分隔符channel and name. channel可以是 规范频道名称或频道 URL。在规范字符串中 表示时，将始终使用规范的通道名称。
6. If channel是一个精确值并且subdir是一个精确值，subdir被附加到channel with a /分隔器。否则，subdir包含在键值括号中。
7. 键值括号可以用逗号、空格或逗号+空格分隔。值可以选择用单精度或双精度包裹 引号，但必须换行，如果value包含逗号、空格或 等号。规范格式使用逗号分隔符和单个 引号。
8. 构建 :class 时：MatchSpec来自字符串的实例，键值括号内给出的任何键值对都会覆盖任何 括号外给出的匹配参数。

支持的按键

除了字符串中显式表示的字段之外，还支持以下键：

• build_number
• track_features
• features
• url
• md5
• license
• license_family
• fn

_{Note: fn stands for filename.}

Examples

该文档继续给出示例，展示如何使用它MatchSpec类来生成这些规范字符串：

>>> str(MatchSpec(name='foo', build='py2*', channel='conda-forge'))
'conda-forge::foo[build=py2*]'

>>> str(MatchSpec('foo 1.0 py27_0'))
'foo==1.0=py27_0'

>>> str(MatchSpec('foo=1.0=py27_0'))
'foo==1.0=py27_0'

>>> str(MatchSpec('conda-forge::foo[version=1.0.*]'))
'conda-forge::foo=1.0'

>>> str(MatchSpec('conda-forge/linux-64::foo>=1.0'))
"conda-forge/linux-64::foo[version='>=1.0']"

>>> str(MatchSpec('*/linux-64::foo>=1.0'))
"foo[subdir=linux-64,version='>=1.0']"