3 个版本
新 0.1.2 | 2024 年 8 月 27 日 |
---|---|
0.1.1 | 2024 年 8 月 26 日 |
0.1.0 | 2024 年 8 月 26 日 |
18 在 构建实用工具 中
147 每月下载量
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
环境变量中。
解决方案是...
- 要么手动将
~/.cargo/bin
添加到PATH
- 或者从包管理器卸载 Rust 并使用
rustup
的官方方式安装: https://www.rust-lang.net.cn/tools/install
现在,进入新初始化的目录,启动 Rustlings 以获取有关如何开始练习的更多说明
cd rustlings/
rustlings
工作环境
编辑器
我们的一般推荐是带有 rust-analyzer 插件 的 VS Code。但任何支持 rust-analyzer 的编辑器都足以用于练习。
终端
在使用 Rustlings 时,请使用现代终端以获得最佳用户体验。Linux 和 Mac 的默认终端应该足够。在 Windows 上,我们推荐使用 Windows Terminal。
做练习
练习按主题排序,可以在子目录 exercises/<topic>
中找到。对于每个主题,都有一个额外的 README.md
文件,其中包含有关该主题的资源。我们强烈建议在开始之前查看它们。
大多数练习包含一个错误,使它们无法编译,而修复这些错误取决于您!一些练习包含需要通过才能完成练习的测试。
搜索 TODO
和 todo!()
以找出您需要更改的内容。在 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