# rust

**Repository Path**: solidify-the-foundation/rust

## Basic Information

- **Project Name**: rust
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-31
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Rust 学习之路 🦀

> 从零开始系统学习 Rust 编程语言，包含完整的学习计划、练习项目和丰富的学习资源

## 📖 项目简介

这是一个系统化的 Rust 学习项目，旨在帮助初学者从零开始掌握 Rust 编程语言。项目包含：

- 📅 **30 天学习计划**：科学规划的学习路径，从入门到精通
- 🎯 **里程碑项目**：4 个实战项目检验学习成果
- 📚 **丰富资源**：精选的中文/英文学习资源大全
- 💻 **练习项目**：每天配套的实际编程练习

## 🌟 项目特色

- ✅ **系统化学习**：循序渐进的知识体系
- ✅ **实战导向**：每个阶段都有可运行的代码示例
- ✅ **成果可验证**：明确的里程碑和检查点
- ✅ **资源齐全**：涵盖官方文档、视频教程、练习平台
- ✅ **持续更新**：跟随 Rust 最新版本

## 📂 目录结构

```
rust/
├── README.md                          # 项目说明（本文件）
├── rust-learning-plan.md              # 30 天详细学习计划
├── rust-learning-resources.md         # 学习资源大全
├── day01/                              # 第 1 天练习
│   ├── README.md                      # 练习说明
│   ├── temperature_converter/          # 温度转换器项目
│   │   ├── Cargo.toml
│   │   └── src/
│   │       └── main.rs
│   └── simple_calculator/             # 简单计算器项目
│       ├── Cargo.toml
│       └── src/
│           └── main.rs
├── day02/                              # 第 2 天练习（待添加）
├── day03/                              # 第 3 天练习（待添加）
...
└── projects/                           # 里程碑项目
    ├── milestone-1-calculator/         # 命令行计算器（Day 7）
    ├── milestone-2-crawler/            # 多线程爬虫（Day 14）
    ├── milestone-3-task-cli/           # 任务管理 CLI（Day 21）
    └── milestone-4-final-project/      # 综合项目（Day 30）
```

## 🚀 快速开始

### 前置要求

- 已安装 Rust（如未安装，请查看 [安装指南](https://www.rust-lang.org/zh-CN/tools/install)）
- 建议使用 VSCode + rust-analyzer 插件

### 安装 Rust

```bash
# macOS/Linux
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 验证安装
rustc --version
cargo --version
```

### 开始学习

1. **阅读学习计划**
   ```bash
   # 查看完整的学习计划
   cat rust-learning-plan.md
   ```

2. **运行第一天的练习**
   ```bash
   # 进入温度转换器项目
   cd day01/temperature_converter
   cargo run
   
   # 进入简单计算器项目
   cd day01/simple_calculator
   cargo run
   ```

3. **运行测试**
   ```bash
   cargo test
   ```

4. **代码检查**
   ```bash
   cargo clippy
   cargo fmt
   ```

## 📅 学习计划概览

### 第一周：基础入门（Day 1-7）

| 天数 | 学习主题 | 练习项目 |
|------|---------|---------|
| Day 1 | 环境搭建 + 基础语法 | 温度转换器、计算器 |
| Day 2 | 控制流 + 所有权基础 | 猜数字游戏 |
| Day 3 | 结构体与方法 | Rectangle 练习 |
| Day 4 | 枚举与模式匹配 | JSON 解析器 |
| Day 5 | 集合与泛型 | 待办事项列表 |
| Day 6 | Trait 与生命周期 | 自定义 Trait |
| Day 7 | 模块系统 + 测试 | **里程碑 1：命令行计算器** |

### 第二周：深入理解（Day 8-14）

- 智能指针、并发编程、异步编程
- 迭代器、闭包、Cargo 进阶
- **里程碑 2：多线程爬虫**

### 第三周：生态系统（Day 15-21）

- 标准库深入、错误处理
- 文件 I/O、网络编程、数据库
- **里程碑 3：任务管理 CLI**

### 第四周：高级主题（Day 22-30）

- 宏编程、Unsafe Rust、性能优化
- Web 开发实战
- **里程碑 4：综合项目**

详细计划请查看 [rust-learning-plan.md](rust-learning-plan.md)

## 📚 学习资源

### 官方文档（必读）

- 📖 [Rust 程序设计语言](https://rustwiki.org/zh-CN/book) - 官方教程中文版
- 💻 [通过例子学 Rust](https://rustwiki.org/zh-CN/rust-by-example) - 代码示例驱动学习
- 📚 [Rust 标准库](https://rustwiki.org/zh-CN/std) - API 文档

### 练习平台

- 🎯 [Rustlings](https://github.com/rust-lang/rustlings) - 官方练习工具
- 📝 [Exercism Rust Track](https://exercism.org/tracks/rust) - 导师指导练习
- 🔢 [LeetCode](https://leetcode.com/) - 算法练习

### 视频教程

- 🎥 [Rust 编程语言入门教程](https://www.bilibili.com/video/BV1hp4y1k7SV) - B站完整教程
- 📺 [程序君的 Rust 培训](https://www.bilibili.com/video/BV19b4y1o7Lt) - 实战导向

完整资源列表请查看 [rust-learning-resources.md](rust-learning-resources.md)

## 🎯 里程碑项目

### 里程碑 1：命令行计算器（Day 7）
- ✅ 支持四则运算和括号
- ✅ 历史记录功能
- ✅ 模块化设计
- ✅ 单元测试

### 里程碑 2：多线程爬虫（Day 14）
- ✅ 多线程并发爬取
- ✅ 配置管理
- ✅ 结果存储
- ✅ 错误处理

### 里程碑 3：任务管理 CLI（Day 21）
- ✅ CRUD 功能
- ✅ 数据持久化
- ✅ 多种输出格式
- ✅ 测试覆盖

### 里程碑 4：综合项目（Day 30）
选择一：
- 博客系统后端 API
- 实时聊天服务器
- 待办事项 API 服务

## 📊 学习进度跟踪

### 如何使用本项目

1. **每天学习前**
   ```bash
   # 创建当天的学习文件夹
   mkdir dayXX
   ```

2. **学习过程中**
   ```bash
   # 完成练习后运行测试
   cargo test
   
   # 检查代码质量
   cargo clippy
   cargo fmt
   ```

3. **学习完成后**
   - ✅ 勾选学习计划中的检查项
   - 📝 记录学习笔记
   - 💾 提交代码到 Git

### 学习记录模板

```markdown
## Day X - 学习主题

### 今日收获
- 知识点 1
- 知识点 2

### 遇到的问题
- 问题 1：描述
- 解决方案：...

### 练习完成情况
- [x] 练习 1
- [ ] 练习 2

### 明日计划
- 学习 XXX
- 完成 YYY
```

## 🛠️ 开发工具推荐

### VSCode 配置

必装插件：
1. **rust-analyzer** - Rust 语言服务器
2. **CodeLLDB** - 调试支持
3. **Better TOML** - Cargo.toml 支持
4. **Error Lens** - 错误提示增强

### 常用命令

```bash
# 创建新项目
cargo new project_name

# 运行项目
cargo run

# 构建项目
cargo build

# 运行测试
cargo test

# 代码检查
cargo clippy

# 代码格式化
cargo fmt

# 生成文档
cargo doc --open

# 查看依赖树
cargo tree
```

## 🤝 贡献指南

欢迎贡献代码、提出问题或分享学习心得！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 创建 Pull Request

## 💬 学习交流

- 📧 遇到问题欢迎提 Issue
- 💡 有好的学习资源欢迎分享
- 🎉 完成里程碑欢迎展示成果

## 📝 更新日志

- **2026-05-31**：创建项目，完成学习计划和资源文档
- **2026-05-31**：添加 Day 1 练习项目

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 🌟 致谢

感谢 Rust 社区和所有贡献者的无私奉献，让学习 Rust 变得更加容易！

---

**Happy Coding with Rust! 🦀**

> "Rust 的学习曲线虽然陡峭，但一旦掌握，你会发现它的强大和优雅。" - Rust 社区