13 个版本 (4 个稳定版本)
6.2.0 | 2024 年 8 月 9 日 |
---|---|
6.1.0 | 2024 年 7 月 10 日 |
6.0.0-beta.9 | 2024 年 5 月 13 日 |
6.0.0-beta.6 | 2024 年 4 月 28 日 |
0.1.0 |
|
#22 in Rust 模式
8,028 每月下载量
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 Code 和 rust-analyzer 插件 的 VS Code。但任何支持 rust-analyzer 的编辑器都应该足够用于处理练习。
终端
在使用 Rustlings 时,请使用现代终端以获得最佳用户体验。Linux 和 Mac 的默认终端应该足够。在 Windows 上,我们推荐使用 Windows Terminal。
做练习
练习按主题排序,可在子目录 exercises/<topic>
中找到。对于每个主题,都有一个额外的 README.md
文件,其中包含一些资源,以帮助您开始学习该主题。我们强烈建议您在开始之前查看它们 📚️
大多数练习都包含一个错误,这阻止了它们的编译,而修复这个错误则是您的任务!一些练习包含需要通过的测试,才能完成练习 ✅
搜索 TODO
和 todo!()
以找到您需要更改的内容。在 监视模式 中输入 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