crm (Cargo registry manager)
crm
是一个在终端运行的镜像管理程序,能够对 Cargo
镜像源进行简单的添加、修改、删除操作,并能帮助您快速的切换不同的 Cargo
镜像源。crm
内置了多种国内 (中国) 镜像源,它们分别是:sjtu
, tuna
, ustc
, rsproxy
,bfsu
, nju
, hit
。
在使用 Rust 语言做开发时,使用 Rust 官方镜像源进行 cargo build
的速度非常的慢,可能会因为网络的原因导致依赖下载超时而无法完成编译。为了能够在最少的时间内完成打包操作,一般会使用国内镜像源来代替官方镜像。
通常,大家一般会手动修改 ~/.cargo/config
文件来完成镜像的切换,手动修改配置文件的工作是繁琐的,它需要手动打开文件所在的目录,还要记住每一个镜像源的地址和配置方式,在不知道哪个国内源的网速最快的时候,我们还需要对镜像的速度进行手动的测速,在使用国内镜像源的过程中,如果当前所使用的国内镜像源也挂了,我们还需要切换到另一个国内镜像源,这就显得非常的棘手。如果您手动配置了国内镜像源,并且还经常的通过 cargo publish
发包的话 ,那么在发包之前,还需要将国内镜像源再手动切换为官方镜像。在比如,每一个国内镜像源同步镜像的时间是不一样的,如果您刚发了一个包并且想第一时间应用到您的项目中,但是因为国内镜像源的没有及时的同步镜像,而导致包无法下载,这个时候您还需要切换到官方镜像源来下载最新发布的包。每一次手动切换镜像的操作都是繁琐且耗时的,而 crm
就是为了解决上述的问题。
安装
通过 cargo
安装
# 在终端执行
Arch
安装
您可以从 Arch Linux 用户仓库安装它,感谢 taotieren。
使用
crm
的原则是使用最小依赖,并尽可能的简化终端操作。您只需要在终端键入 crm
即可获得命令帮助信息。
# 在终端执行
#
# NOTE:
# - [args] 表示 args 是一个或多个可选参数
# - <name> 表示 name 是一个必填参数
#
# 下面这些命令在执行时会自动切换为官方镜像,避免了手动切换镜像的麻烦:
# - `crm install` 对应 `cargo install`
# - `crm publish` 对应 `cargo publish`
# - `crm update` 对应 `cargo update`
#
# `crm test` 命令一般用于进行全量测试,而 `crm best` 是切换到最优镜像的快速方式
)
)
- 根据 反馈,并不建议您使用
ustc
镜像源,它会限制并发 - 以下镜像只能在更新
git
镜像仓库时获得加速效果,在下载包时无法获得加速效果:tuna
bfsu
nju
hit
在项目中使用来自不同镜像源的依赖
crm
在配置镜像源时,会默认在 ~/.cargo/config
中多增加一个 registries
属性对象,通过增加该属性对象,您就可以在项目中应用来自于不同镜像源的依赖。比如您在使用官方镜像源时,可以通过在项目的 Cargo.toml
文件中指定依赖的 registry
属性来使用不同的国内镜像源。如果您已经在使用国内镜像源了,那么也可以通过修改 registry
属性的方式来切换到其他的国内镜像源。以下是一个示例。
# Cargo.toml
# 使用官方镜像源时,`registry` 属性可选的值为: `sjtu`, `tuna`, `ustc`, `rsproxy`, `bfsu`, `nju`, `hit`
# 如果您已经使用 `crm` 切换到了 `rsproxy` 镜像源,那么 `registry` 属性可选的值则为其他国内镜像:`sjtu`, `tuna`, `ustc`, `bfsu`, `nju`, `hit`
# 以此类推
# 值得注意的是,在使用国内镜像源时,您无法直接通过修改 `registry` 属性的方式使用官方镜像源
# 如果您想使用官方镜像源,那么请在终端执行 `crm default` 来切换到官方镜像
[]
# 使用 `ustc` 国内镜像来下载 `log` 依赖
= { = "0.4.12", = "ustc"}
# 使用 `sjtu` 国内镜像来下载 `lazy_static` 依赖
= { = "1.4.0", = "sjtu"}
NOTE:
- 如果您刚安装
crm
,那么请在终端执行一次:crm default
,然后就可以在项目的Cargo.toml
文件中配置registry
属性了。- 从 Rust v1.39.0 版本开始,
~/.cargo/config.toml
将被推荐使用,如果~/.cargo/config
和~/.cargo/config.toml
同时存在,则优先使用~/.cargo/config
配置。
使用 sparse
协议
在 v1.68.0
版本中,新增了一个 sparse
协议。以前我们更新注册表默认都是通过克隆 git
仓库来实现的,在克隆 git
仓库时会出现明显的延迟,sparse
协议的好处就是不用再克隆镜像源仓库了,而是仅通过 HTTPS 从网络上查询和下载您所需要的包。虽然该协议避免了 git
克隆的步骤,但是当镜像源的网络不稳定时较容易出错。
按照官方说法,使用该协议有两种方式:
- 将
export CARGO_REGISTRIES_CRATES_IO_PROTOCOL=sparse
加入到.bashrc
或.zshrc
文件中 - 或者编辑
~/.cargo/config
文件:
但是,当您使用 crm
时,crm
自带了一些支持 sparse
协议的镜像源,它们是开箱即用的。只须执行 crm best sparse
或 crm best sparse-download
即可轻松切换到支持 sparse
协议的镜像源。
如果您想了解更多的内容,请参考下面的链接:
- https://blog.rust-lang.org/2023/03/09/Rust-1.68.0.html#cargos-sparse-protocol
- https://doc.rust-lang.org/cargo/reference/config.html#registriescrates-ioprotocol
- https://github.com/rust-lang/cargo/issues/9069
- https://internals.rust-lang.org/t/call-for-testing-cargo-sparse-registry/16862/20
- https://blog.rust-lang.org/2022/06/22/sparse-registry-testing.html
注意事项
v0.1.0
版本以下的.crmrc
配置文件和最新版本的配置文件并不能相互兼容,如果您正在使用小于v0.1.0
的版本,当您更新到最新版本时,请手动删除~/.crmrc
文件crm
会修改~/.cargo/config
文件来进行镜像源的切换,如果您使用的是小于v0.1.3
的版本,那么当您使用crm
切换镜像时,~/.cargo/config
文件中的文档注释会被删除并且永远无法恢复,如果您在~/.cargo/config
文件中保存了笔记或者文档,请尽快更新到最新版,在最新版中,对此进行了优化,不再自动删除文档注释 (除修改的字段外)crm
默认会在~/.cargo/config
文件中增加一个env.git-fetch-with-cli
属性,值为true
,在使用crm
时您无法删除该选项,如果您不想使用Git
可执行文件进行Git
操作,请手动修改~/.cargo/config
文件并将git-fetch-with-cli
的值修改为false
Others
rust-library-chinese
rust-library-chinese
是 Rust 核心库和标准库的源码级中文翻译,可以用作 IDE 工具的中文智能提示,也可以基于翻译好的内容生成 Rust 中文 API 文档。
LICENSE
MIT OR Apache-2.0