• Stars
    star
    175
  • Rank 218,059 (Top 5 %)
  • Language
    Rust
  • License
    MIT License
  • Created almost 2 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Rustlings 非官方中文翻译(Rustlings unofficial chinese verion)。🦀 让你熟悉阅读和编写 Rust 代码的小练习。源仓库:https://github.com/rust-lang/rustlings

rustlings 🦀❤️

你好,欢迎来到 rustlings。这个项目包括一些让你熟悉阅读和编写 Rust 代码的小练习。这包括阅读和响应编译器信息!

...寻找老版本的基于web的 Rustlings 版本? 试试 这里

或者,对于第一次学习 Rust 的人,这里还有一些其它的资源:

开始

注意:如果你使用 MacOS,请确认你已经通过输入 xcode-select --install 安装了 Xcode 以及它的开发者工具

注意:如果你使用 Linux,请确认你已经安装了 gcc。Deb: sudo apt install gcc。 Yum: sudo yum -y install gcc

你需要安装 Rust。你可以通过 https://rustup.rs 获取。这同时将会安装 Cargo,其为 Rust 的包/项目管理器。

MacOS/Linux

只需要执行:

curl -L https://raw.githubusercontent.com/rust-lang/rustlings/main/install.sh | bash
# 或者如果你希望在其它路径上安装
curl -L https://raw.githubusercontent.com/rust-lang/rustlings/main/install.sh | bash -s mypath/

这将会安装 Rustlings 并让你可以使用 rustlings 命令,运行它开始吧!

Nix

基本上:在最新 tag 处克隆本仓库,最后运行 nix develop 或者 nix-shell

# 在 https://github.com/rust-lang/rustlings/releases/latest 获取最新版本 (编辑此文档时是 5.3.0)
git clone -b 5.3.0 --depth 1 https://github.com/rust-lang/rustlings
# 译者注:为了降低工作量,该仓库只维护main分支,所以直接克隆本仓库的主分支就行
git clone -b main --depth 1 https://github.com/rust-lang-cn/rustlings-cn.git
cd rustlings
# 如果 nix 版本号 > 2.3
nix develop
# 如果 nix 版本号 <= 2.3
nix-shell

Windows

在 Powershell (使用管理员身份运行),设置 ExecutionPolicyRemoteSigned

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

然后,你可以运行:

Start-BitsTransfer -Source https://raw.githubusercontent.com/rust-lang/rustlings/main/install.ps1 -Destination $env:TMP/install_rustlings.ps1; Unblock-File $env:TMP/install_rustlings.ps1; Invoke-Expression $env:TMP/install_rustlings.ps1

安装 Rustlings。与 MacOS/Linux 一样,安装完成之后你将可以访问 rustlings 命令。请注意,它在 PowerShell 中表现最好,任何其它的终端都有可能会出错。

如果你收到权限被拒绝的信息,你可能必须在防病毒软件中排除克隆 Rustlings 的目录。

浏览器

在 Repl.it 运行

在 Gitpod 打开

手动安装

基本上:在最新 tag 处克隆该仓库,执行 cargo install --path .

# 在 https://github.com/rust-lang/rustlings/releases/latest 获取最新版本 (编辑此文档时是 5.3.0)
git clone -b 5.3.0 --depth 1 https://github.com/rust-lang/rustlings
# 译者注:为了降低工作量,该仓库只维护main分支,所以直接克隆本仓库的主分支就行
git clone -b main --depth 1 https://github.com/rust-lang-cn/rustlings-cn.git
cd rustlings
cargo install --force --path .

如果遇到任何安装错误,请确保你的工具链是最新的。运行以下命令来获取最新版本:

rustup update

然后,与之前说的一样,运行 rustlings 以开始。

做练习

练习按主题排序,你可以在子目录 rustlings/exercises/<topic> 下看到。每个主题有一个额外的 README 文件,内含一些资源以帮助你开始该主题。我们强烈推荐你在开始练习之前查看这些资源。

任务是简单的。大多数练习包含一个错误导致它们无法被编译,需要你来修复它!一些练习也作为测试运行,但是 rustlings 处理他们的方式是一样的。要以推荐的顺序运行练习,请执行:

rustlings watch

这将会尝试按预定顺序(我们认为最适合新手的顺序)验证每个练习的完成情况。它也会在你每次更改 exercises/ 路径下的文件时自动运行。如果你想要它只运行一次,可以使用:

rustlings verify

这与 watch 功能做的事情一样,但是会在运行完成后自动退出。

如果你想要以你自己的顺序进行,或者只想验证一个练习,可以运行:

rustlings run myExercise1

或者简单地使用下面的命令来运行课程中下一个未解决的问题:

rustlings run next

如果遇到困难,可以运行以下命令来获取练习的提示:

rustlings hint myExercise1

你也可以通过以下指令获得下一个未解决问题的提示:

rustlings hint next

可以通过以下指令检查你的进度:

rustlings list

自我测评

在每几个部分之后,会有一个测验来测试你在这些部分的所学内容。这些测试可以在 exercises/quizN.rs 中找到。

启用 rust-analyzer

运行 rustlings lsp 命令来在工程的根目录生成 rust-project.json,这会允许 rust-analyzer 解析每个练习。

更进一步

完成 Rustlings 后,充分利用你的新知识!通过构建你自己的项目、为 Rustlings 或你找到的其它开源项目做贡献,继续练习你的 Rust 技能。

卸载 Rustlings

如果你想要从你的系统中移除 Rustlings,需要进行两个步骤。首先,你需要删除安装脚本为你创建的练习文件夹:

rm -rf rustlings # 或者你自定义的文件夹名字,如果你选择或重命名了它

然后,由于 Rustlings 是通过 cargo install 安装的,因此可以合理地假设你也可以使用 Cargo 将其删除,事实确实如此。运行 cargo uninstall 以删除 rustlings 的二进制可执行文件:

cargo uninstall rustlings

现在你应该已经搞定了!

贡献

详见 CONTRIBUTING.md.

关于 Rustlings 的以开发为中心的讨论在 Zulip 上的 Rust 项目rustlings 中发生。如果你有想法或建议,请随时在那里开启一个新线程!

贡献者

感谢 AUTHORS.md 中列出的优秀人员 🎉