3 个版本

0.1.2 2024 年 8 月 27 日
0.1.1 2024 年 8 月 26 日
0.1.0 2024 年 8 月 26 日

18构建实用工具

Download history 147/week @ 2024-08-21

147 每月下载量

MIT 许可协议

300KB
7.5K SLoC

Collective-Rustlings 🦀❤️

这是 Rustlings 的分支,集成了 collective-score,用于我的 Rust 课程。此分支不打算取代 Rustlings!除非您正在参加我的课程,否则请使用原始的 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-mo8it-course
如果安装失败... (点击展开)
  • 请确保您有最新的 Rust 版本,运行以下命令:rustup update
  • 尝试添加 --locked 标志: cargo install rustlings-mo8it-course --locked
  • 否则,请报告问题

注册

在开始这些练习之前,请在以下命令中将 USERNAME 替换为您希望在课程中看到的其他用户名。建议使用匿名名称,因为得分的用户名可以公开访问。

rustlings register USERNAME

初始化

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

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

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

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

解决方案是...

现在,进入新初始化的目录,启动 Rustlings 以获取有关如何开始练习的更多说明

cd rustlings/
rustlings

工作环境

编辑器

我们的一般推荐是带有 rust-analyzer 插件VS Code。但任何支持 rust-analyzer 的编辑器都足以用于练习。

终端

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

做练习

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

大多数练习包含一个错误,使它们无法编译,而修复这些错误取决于您!一些练习包含需要通过才能完成练习的测试。

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

Watch 模式

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

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

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

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

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

练习列表

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

列表允许您...

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

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

继续

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

卸载Rustlings

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

cargo uninstall rustlings

依赖项

~11-24MB
~391K SLoC