rust 笔记
Crate 国内源配置
作者:李俊才 (jcLee95):https://blog.csdn.net/qq_28550263?spm=1001.2101.3001.5343
邮箱 :291148484@163.com
本文地址:https://blog.csdn.net/qq_28550263/article/details/130758057
目 录
- 1. 概述
- 2. Window 下配置国内源
-
- 2.1 新建配置文件
- 2.2 编辑配置文件
- 2.3 也可以直接打开编辑器编辑
- 2.4 powershell 命令添加环境变量
- 3. Linux 下配置 cargo 国内源
-
- 3.1 安装 vim
- 3.2 编写配置文件
- 4. 关于 cargo 国内源
-
- 字节跳动源
-
- crates.io 镜像
- Rustup 镜像:
- 上海交大源
- 清华源
-
- Rust crates.io 索引镜像
- Rust crates.io 稀疏索引镜像
- 中科大源
1. 概述
Rust 官方默认的 Cargo 源服务器为 crates.io,其同时也是 Rust 官方的 crate 管理仓库,但是由于官方服务器部署在北美洲,中国大陆用户下载速度较慢,甚至反复中断下载——你是否正在经历 cargo 安装模块太慢?甚至进度卡停?
cargo add xxxx
Updating crates.io xxxx
warning: spurious network error (2 tries remaining): failed to receive response: 操作超时
; class=Os (2)
Fetch [======> ] 30.16%, 415.60KiB/s
… enmm,不用担心。当你主动来查找时,那么就如你所猜想的,作为 rust
语言的包管理器的 cargo
,当然也有国内源。
2. Window 下配置国内源
2.1 新建配置文件
如果你安装好了 rust,在你的 用户主目录 中有一个.cargo
目录。其中用户主目录一般是 C:Users
+当前用户名 为路径的目录。
2.2 编辑配置文件
如果安装完成了 rust 当前用户目录下有一个 .cargo
目录。新建 config
文件,编辑内容:
[source.crates-io]
replace-with='rsproxy'
[source.rsproxy]
registry="https://rsproxy.cn/crates.io-index"
[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index"
[net]
git-fetch-with-cli = true
2.3 也可以直接打开编辑器编辑
使用 Windows 的系统环境变量 $HOME
可以直接指向主目录。如果你安装了 VSCode,可以打开一个终端,输入以下命令:
code $HOME/.cargo/config
其中,code
所使用的是 VScode 的可执行文件:code.exe。运行上面命令后,VSCode 自动打开一个指向 config 文件的空文件:
然后编辑之前的内容,并保存即可。
2.4 powershell 命令添加环境变量
如果尽在本窗口有效,则可以使用以下命令:
$env:RUSTUP_DIST_SERVER="https://mirrors.sjtug.sjtu.edu.cn/rust-static"
$env:RUSTUP_UPDATE_ROOT="https://mirrors.sjtug.sjtu.edu.cn/rust-static/rustup"
你可以使用以下方式查看是否设置成功:
Write-Host $env:RUSTUP_DIST_SERVER
Write-Host $env:RUSTUP_UPDATE_ROOT
如需要写入为长期的环境变量则需要使用以下命令(其中User
表示环境变量级别为当前用户,你也可以设置为系统级变量):
[System.Environment]::SetEnvironmentVariable('RUSTUP_DIST_SERVER','https://mirrors.sjtug.sjtu.edu.cn/rust-static','User')
[System.Environment]::SetEnvironmentVariable('RUSTUP_UPDATE_ROOT','https://mirrors.sjtug.sjtu.edu.cn/rust-static/rustup','User')
3. Linux 下配置 cargo 国内源
3.1 安装 vim
如果已经安装有 vim / vi 或之类编辑工具则可以忽略。
# linux 的 debin 版本如 ubuntu 使用 apt 包管理器。如使用 centOS 的改用 yum 包管理器安装
sudo apt update
sudo apt install vim
(如果你在 docker 容器中,不需要 sudo)
3.2 编写配置文件
使用 vim 新建(或编辑已有)一个config
文件:
sudo vim ~/.cargo/config
(如果你在 docker 容器中,不需要 sudo)
这时 vim 建立一个新的为保存config文件,英文输入模式下,输入 i
进入编辑模式,添加以下内容(和在Windows 时编辑的配置文件一样):
[source.crates-io]
replace-with='rsproxy'
[source.rsproxy]
registry="https://rsproxy.cn/crates.io-index"
[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index"
[net]
git-fetch-with-cli = true
依次 exit
、:wq!
保存退出。
4. 关于 cargo 国内源
除了上面给出的配置,你可可以参考本节挑选一个自己喜欢的国内源进行配置。
字节跳动源
文档地址:https://rsproxy.cn/
crates.io 镜像
~/.cargo/config
:
[source.crates-io]
# To use sparse index, change 'rsproxy' to 'rsproxy-sparse'
replace-with = 'rsproxy'
[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"
[source.rsproxy-sparse]
registry = "sparse+https://rsproxy.cn/index/"
[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index"
[net]
git-fetch-with-cli = true
Rustup 镜像:
~/.zshrc or ~/.bashrc:
export RUSTUP_DIST_SERVER="https://rsproxy.cn"
export RUSTUP_UPDATE_ROOT="https://rsproxy.cn/rustup"
上海交大源
地址:https://mirrors.sjtug.sjtu.edu.cn/docs/rust-static
使用方法:安装rustup,将以下环境变量加入~/.bashrc或类似文件中:
export RUSTUP_DIST_SERVER=https://mirror.sjtu.edu.cn/rust-static
export RUSTUP_UPDATE_ROOT=https://mirror.sjtu.edu.cn/rust-static/rustup
清华源
Rust crates.io 索引镜像
文档地址:https://mirrors.tuna.tsinghua.edu.cn/help/crates.io-index.git/
编辑 ~/.cargo/config 文件,添加以下内容:
[source.crates-io]
replace-with = 'mirror'
[source.mirror]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"
Rust crates.io 稀疏索引镜像
文档地址:https://mirrors.tuna.tsinghua.edu.cn/help/crates.io-index/
编辑 ~/.cargo/config 文件,添加以下内容:
[source.crates-io]
replace-with = 'mirror'
[source.mirror]
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"
注:sparse+ 表示在使用稀疏索引,链接末尾的 / 不能缺少。
截至目前,可以通过 cargo +nightly -Z sparse-registry update 使用稀疏索引。
cargo 1.68 版本开始支持稀疏索引:不再需要完整克隆 crates.io-index 仓库,可以加快获取包的速度。如果您的 cargo 版本大于等于 1.68,可以直接使用而不需要开启 nightly。
中科大源
文档地址:http://mirrors.ustc.edu.cn/help/crates.io-index.html
Windows 用户在使用 crates 源时可能会出现 next InitializeSecurityContext failed: Unknown error 错误(见 https://github.com/ustclug/discussions/issues/339 和 https://github.com/rust-lang/cargo/issues/7096)。一个 workaround 是在运行 cargo 的时候加入环境变量 CARGO_HTTP_CHECK_REVOKE=false,或者在配置中增加:
[http] check-revoke = false
cargo 1.68 版本开始支持稀疏索引:不再需要完整克隆 crates.io-index 仓库,可以加快获取包的速度。如果您的 cargo 版本大于等于 1.68,可以在
$HOME/.cargo/config
中添加如下内容:[source.crates-io] replace-with = 'ustc' [source.ustc] registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/"
在 $HOME/.cargo/config
中添加如下内容:
[source.crates-io]
replace-with = 'ustc'
[source.ustc]
registry = "git://mirrors.ustc.edu.cn/crates.io-index"
如果所处的环境中不允许使用 git 协议,可以把上述地址改为:
registry = "https://mirrors.ustc.edu.cn/crates.io-index"