Rustlings 🦀❤️

欢迎来到 Rustlings。

本项目包含一些小练习，旨在帮助你熟悉阅读和编写 Rust 代码。 这包括阅读和理解编译器消息！

建议在阅读Rust官方教程的同时完成 Rustlings 练习，这是学习 Rust 最全面的资源 📚️

通过例子学 Rust 是另一个推荐的资源，你可能会觉得它很有帮助。 它包含类似 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 及其开发者工具，运行 xcode-select --install。

安装 Rustlings

以下命令将下载并编译 Rustlings：

cargo install rustlings

<details> <summary><strong>如果安装失败…</strong>（<em>点击展开</em>）</summary>

• 运行 rustup update 确保你使用的是最新版本的 Rust
• 尝试添加 --locked 标志：cargo install rustlings --locked
• 否则，请报告问题

</details>

初始化

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

rustlings init

<details> <summary><strong>如果找不到 <code>rustlings</code> 命令…</strong>（<em>点击展开</em>）</summary>

你可能使用的是 Linux，并通过包管理器安装了 Rust。

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

解决方法是…

• 手动将 ~/.cargo/bin 添加到 PATH 中
• 或从包管理器卸载 Rust，然后使用官方方式通过 rustup 安装：https://www.rust-lang.org/tools/install

</details>

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

cd rustlings/
rustlings

工作环境

编辑器

我们的一般建议是使用 VS Code 和 rust-analyzer 插件。 但任何支持 rust-analyzer 的编辑器都应该足以完成练习。

终端

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

完成练习

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

大多数练习都包含一个阻止它们编译的错误，你需要修复它！ 一些练习包含需要通过的测试，以完成练习 ✅

搜索 TODO 和 todo!() 以找出需要更改的内容。 在_监视模式_下输入 h 可以获取提示 💡

监视模式

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

这将启动_监视模式_，按预定义的顺序（我们认为对新手最好的顺序）引导你完成练习。 每次你更改 exercises/ 目录中的练习文件时，它都会自动重新运行当前练习。

<details> <summary><strong>如果检测 <code>exercises/</code> 目录中的文件更改失败…</strong>（<em>点击展开</em>）</summary>

你可以添加 --manual-run 标志（rustlings --manual-run），在监视模式下输入 r 手动重新运行当前练习。

请报告问题，并提供一些关于你的操作系统以及你是否在容器或虚拟机（如 WSL）中运行 Rustlings 的信息。

</details>

练习列表

在监视模式下（启动 rustlings 后），你可以输入 l 打开交互式练习列表。

该列表允许你…

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

查看列表底部了解所有可能的按键。

继续前进

一旦你完成了 Rustlings，就把你的新知识付诸实践！ 通过构建自己的项目、为 Rustlings 做贡献或寻找其他开源项目来继续练习你的 Rust 技能。

第三方练习

你想创建自己的 Rustlings 练习集，专注于某些特定主题吗？ 或者你想翻译原始的 Rustlings 练习？ 那么请查看第三方练习指南！

卸载 Rustlings

如果你想从系统中删除 Rustlings，请运行以下命令：

cargo uninstall rustlings

贡献

请参阅 CONTRIBUTING.md 🔗

贡献者 ✨

感谢所有出色的贡献者 🎉