13 个版本 (4 个稳定版本)

6.2.0 2024 年 8 月 9 日
6.1.0 2024 年 7 月 10 日
6.0.0-beta.92024 年 5 月 13 日
6.0.0-beta.62024 年 4 月 28 日
0.1.0 2022 年 4 月 8 日

#22 in Rust 模式

Download history 26/week @ 2024-05-04 391/week @ 2024-05-11 34/week @ 2024-05-18 18/week @ 2024-05-25 15/week @ 2024-06-01 15/week @ 2024-06-08 7/week @ 2024-06-15 2/week @ 2024-06-22 1447/week @ 2024-06-29 2340/week @ 2024-07-06 1767/week @ 2024-07-13 2306/week @ 2024-07-20 2107/week @ 2024-07-27 2164/week @ 2024-08-03 1973/week @ 2024-08-10 1483/week @ 2024-08-17

8,028 每月下载量

MIT 许可证

305KB
7.5K SLoC

Rustlings 🦀❤️

问候并欢迎来到 Rustlings。本项目包含小练习,帮助您熟悉阅读和编写 Rust 代码。这包括阅读和响应编译器消息!

建议在阅读 官方 Rust 书籍(学习 Rust 的最全面资源 📚️)的同时进行 Rustlings 练习。

Rust By Example 是另一个推荐的资源,您可能会觉得它很有帮助。它包含与 Rustlings 类似的代码示例和练习,但在线上。

入门

安装 Rust

在安装 Rustlings 之前,您需要安装最新版本的 Rust。访问 www.rust-lang.org/tools/install 获取安装 Rust 的进一步说明。这将也会安装 Cargo,Rust 的包/项目管理器。

🐧 如果您使用 Linux,请确保已安装 gcc(用于链接器)。

Deb: sudo apt install gcc. Dnf: sudo dnf install gcc.

🍎 如果您使用 MacOS,请运行 xcode-select --install 以确保已安装 Xcode 及其开发者工具。

安装 Rustlings

以下命令将下载和编译 Rustlings

cargo install rustlings
如果安装失败… (点击展开)
  • 通过运行 rustup update 确保您拥有最新的 Rust 版本。
  • 尝试添加 --locked 标志: cargo install rustlings --locked
  • 否则,请报告问题

初始化

安装 Rustlings 后,运行以下命令以初始化 rustlings/ 目录

rustlings init
如果找不到命令 rustlings (点击展开)

您可能正在使用 Linux,并使用您的软件包管理器安装 Rust。

Cargo 将二进制文件安装到目录 ~/.cargo/bin。遗憾的是,软件包管理器通常不会将 ~/.cargo/bin 添加到您的 PATH 环境变量中。

解决方案是…

  • ~/.cargo/bin 手动添加到 PATH
  • 或者从软件包管理器中卸载 Rust,并使用 rustup 以官方方式安装:[https://rust-lang.net.cn/tools/install](https://rust-lang.net.cn/tools/install)

现在,进入新初始化的目录并启动 Rustlings,以获取有关开始练习的进一步说明

cd rustlings/
rustlings

工作环境

编辑器

我们的一般建议是使用带有 VS Coderust-analyzer 插件VS Code。但任何支持 rust-analyzer 的编辑器都应该足够用于处理练习。

终端

在使用 Rustlings 时,请使用现代终端以获得最佳用户体验。Linux 和 Mac 的默认终端应该足够。在 Windows 上,我们推荐使用 Windows Terminal

做练习

练习按主题排序,可在子目录 exercises/<topic> 中找到。对于每个主题,都有一个额外的 README.md 文件,其中包含一些资源,以帮助您开始学习该主题。我们强烈建议您在开始之前查看它们 📚️

大多数练习都包含一个错误,这阻止了它们的编译,而修复这个错误则是您的任务!一些练习包含需要通过的测试,才能完成练习 ✅

搜索 TODOtodo!() 以找到您需要更改的内容。在 监视模式 中输入 h 来请求提示 💡

监视模式

初始化 之后,只需运行 rustlings 命令即可启动 Rustlings。

这将启动 监视模式,按预定义的顺序引导您完成练习(我们认为这对新入门者来说是最好的)。每次您更改 exercises/ 目录中的练习文件时,它都会自动重新运行当前练习。

如果在 exercises/ 目录中检测文件更改失败… (点击展开)

您可以在监视模式中通过输入 r 来添加 --manual-run 标志(rustlings -- manual- run)来手动重新运行当前练习。

报告问题,并提供有关您的操作系统和是否在容器或虚拟机(例如 WSL)中运行 Rustlings 的信息。

练习列表

监视模式(启动 rustlings 之后),您可以通过输入 l 来打开交互式练习列表。

该列表允许您…

  • 查看所有练习的状态(已完成或待完成)
  • c:在另一个练习处继续(暂时跳过一些练习或返回上一个练习)
  • r:重置练习的状态和文件(之后需要在您的编辑器中重新加载/打开其文件)

查看列表底部以获取所有可能的键。

继续练习

完成Rustlings后,将您的新知识运用到实践中!通过构建自己的项目、为Rustlings做出贡献或寻找其他开源项目进行贡献来继续练习您的Rust技能。

第三方练习

您想创建自己的Rustlings练习集来专注于某个特定主题吗?或者您想翻译原始的Rustlings练习?那么请跟随链接查看有关第三方练习的指南!

卸载Rustlings

如果您想从系统中删除Rustlings,请运行以下命令

cargo uninstall rustlings

贡献

请参阅CONTRIBUTING.md 🔗

贡献者 ✨

感谢所有杰出的贡献者 🎉

依赖项

~11–21MB
~305K SLoC