包ID规格

Cargo的子命令经常需要引用依赖图中的某个特定包来进行各种操作，如更新、清理、构建等。为了解决这个问题，Cargo支持 包ID规格 。规格是一个字符串，用来唯一地指代包图中的一个包。

该规格可以是完整标准的，例如 https://github.com/rust-lang/crates.io-index#regex@1.4.3 ，也可以是缩写的，例如 regex 。缩写的形式可以使用，只要它在依赖图中唯一地标识了一个包。如果有歧义，可以添加额外的限定词来使其唯一。例如，如果图中有两个版本的 regex 包，那么可以用一个版本来限定，使其唯一，如 regex@1.4.3 。

规格语法

包Id规格形式的语法是:

spec := pkgname
       | proto "://" hostname-and-path [ "#" ( pkgname | semver ) ]
pkgname := name [ ("@" | ":" ) semver ]

proto := "http" | "git" | ...

这里，方括号表示内容是可选的。

URL形式可用于git依赖，或区分来自不同来源的包，如不同的注册中心。

示例规格

以下是对 crates.io 上的 regex 包的引用:

Spec	Name	Version
`regex`	`regex`	`*`
`regex@1.4.3`	`regex`	`1.4.3`
`https://github.com/rust-lang/crates.io-index#regex`	`regex`	`*`
`https://github.com/rust-lang/crates.io-index#regex@1.4.3`	`regex`	`1.4.3`

下面是几个不同的git依赖的规格例子:

Spec	Name	Version
`https://github.com/rust-lang/cargo#0.52.0`	`cargo`	`0.52.0`
`https://github.com/rust-lang/cargo#cargo-platform@0.1.2`	`cargo-platform`	`0.1.2`
`ssh://git@github.com/rust-lang/regex.git#regex@1.4.3`	`regex`	`1.4.3`

文件系统上的本地包可以使用 file:// URL来引用它们:

Spec	Name	Version
`file:///path/to/my/project/foo`	`foo`	`*`
`file:///path/to/my/project/foo#1.1.8`	`foo`	`1.1.8`

规格简略

这样做的目的是为了使在依赖图中引用包的语法既简明又详尽。模糊的引用可能指的是一个或多个包。如果有一个以上的包可以用相同的规格引用，大多数命令会产生一个错误。