Repository files navigation

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

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

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

• Rust 程序设计语言 - 学习 Rust 最全面的资源，但有时有点偏理论性。你将和 Rustlings 一起使用它。
• Rust 程序设计语言（中文版） - 学习 Rust 最全面的资源，但有时有点偏理论性。你将和 Rustlings 一起使用它。
• 通过例子学 Rust - 通过解决小练习来学习 Rust！ 这很像rustlings，但是它是在线的。
• 通过例子学 Rust（中文版） - 通过解决小练习来学习 Rust！ 这很像rustlings，但是它是在线的。

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

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

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

只需要执行:

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 命令，运行它开始吧！

基本上：在最新 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.gitcd rustlings# 如果 nix 版本号 > 2.3nix develop# 如果 nix 版本号 <= 2.3nix-shell

在 Powershell （使用管理员身份运行），设置ExecutionPolicy 为RemoteSigned：

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 运行

基本上：在最新 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.gitcd rustlingscargo 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 中找到。

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

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

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

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

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

cargo uninstall rustlings

现在你应该已经搞定了！

详见CONTRIBUTING.md.

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

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