# rust-running

**Repository Path**: coderwing/rust-running

## Basic Information

- **Project Name**: rust-running
- **Description**: Rust语言学习教程
- **Primary Language**: Rust
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-24
- **Last Updated**: 2025-07-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🦀 Rust开发完整教程

[![Rust](https://img.shields.io/badge/rust-1.70+-orange.svg)](https://www.rust-lang.org)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](http://makeapullrequest.com)

一个从基础到精通的Rust学习教程，特别为Java开发者设计，涵盖系统编程、Web开发和区块链应用开发。

## 🎯 项目特色

- **🔄 Java对比学习**: 每个概念都与Java进行对比，帮助Java开发者快速理解
- **📚 循序渐进**: 从基础语法到高级特性，再到实战应用
- **💼 实战导向**: 包含Web服务、CLI工具、系统编程和区块链等实际应用场景
- **🔐 区块链专题**: 深入讲解密码学、共识算法、智能合约等区块链核心技术
- **✅ 可运行代码**: 所有示例代码都经过测试，确保可以正常运行
- **🛠️ 完整工具链**: 涵盖开发环境、测试、性能优化等完整开发流程

## 📖 教程结构

### 🌱 基础部分 (第1-8章)
掌握Rust的核心概念和基础语法

- [第01章 - Rust环境搭建](基础部分/01-rust入门/) - 开发环境配置与工具链介绍
- [第02章 - 基本语法与数据类型](基础部分/02-基本语法与数据类型/) - 变量、数据类型、控制流
- [第03章 - 所有权系统基础](基础部分/03-所有权系统基础/) - Rust独特的内存管理机制
- [第04章 - 结构化数据](基础部分/04-结构化数据/) - 结构体、枚举、模式匹配
- [第05章 - 模块系统与包管理](基础部分/05-模块系统与包管理/) - 代码组织和依赖管理
- [第06章 - 错误处理](基础部分/06-错误处理/) - Result、Option和错误传播
- [第07章 - 泛型与特质](基础部分/07-泛型与特质/) - 类型抽象和代码复用
- [第08章 - 集合类型](基础部分/08-集合类型/) - Vec、HashMap等常用集合

### 🚀 高级特性 (第9-16章)
深入理解Rust的高级特性和最佳实践

- [第09章 - 深入理解所有权](高级特性/09-深入理解所有权/) - 生命周期、智能指针
- [第10章 - 高级特质](高级特性/10-高级特质/) - 关联类型、特质对象
- [第11章 - 宏系统](高级特性/11-宏系统/) - 声明式宏和过程宏
- [第12章 - 并发编程](高级特性/12-并发编程/) - 线程、消息传递、共享状态
- [第13章 - 异步编程](高级特性/13-异步编程/) - async/await、Future、Stream
- [第14章 - 不安全Rust](高级特性/14-不安全Rust/) - 原始指针、FFI、内存管理
- [第15章 - 高级类型系统](高级特性/15-高级类型系统/) - 类型级编程、常量泛型
- [第16章 - 性能优化](高级特性/16-性能优化/) - 性能分析、优化技巧

### 💼 实战应用 (第17-20章)
通过实际项目掌握Rust在不同领域的应用

- [第17章 - Web服务开发](实战应用/17-web服务开发/) - 使用Axum构建REST API
- [第18章 - 命令行工具开发](实战应用/18-命令行工具开发/) - CLI应用开发最佳实践
- [第19章 - 系统编程案例](实战应用/19-系统编程案例/) - 文件系统、网络编程
- [第20章 - 跨平台应用开发](实战应用/20-跨平台应用开发/) - 桌面应用、移动应用

### ⛓️ 区块链开发 (第21-24章)
深入区块链和加密货币开发

- [第21章 - 密码学基础](区块链开发/21-密码学基础/) - 哈希、数字签名、加密算法
- [第22章 - 区块链基础实现](区块链开发/22-区块链基础实现/) - 区块、交易、共识机制
- [第23章 - 智能合约开发](区块链开发/23-智能合约开发/) - 虚拟机、合约语言
- [第24章 - 区块链应用案例](区块链开发/24-区块链应用案例/) - DeFi、NFT、DAO

## 🚀 快速开始

### 环境要求

- **Rust**: 1.70.0 或更高版本
- **操作系统**: Windows 10+, macOS 10.15+, Linux (Ubuntu 18.04+)
- **内存**: 至少 4GB RAM
- **存储**: 至少 2GB 可用空间

### 安装Rust

```bash
# 安装Rust工具链
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 重新加载环境变量
source ~/.cargo/env

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

### 克隆项目

```bash
git clone https://github.com/your-username/rust-blockchain-tutorial.git
cd rust-blockchain-tutorial
```

### 运行示例

```bash
# 运行第一个示例
cd "基础部分/01-rust入门/examples/hello_world"
cargo run

# 运行区块链示例
cd "区块链开发/21-密码学基础"
cargo run

# 运行所有测试
make test-all
```

## 📚 学习路径建议

### 🔰 初学者路径 (0-2个月)
适合完全没有Rust经验的开发者

1. **第1-4周**: 基础部分 (第1-8章)
2. **第5-6周**: 高级特性 (第9-12章)
3. **第7-8周**: 实战应用 (第17-18章)

### 🎯 进阶路径 (2-4个月)
适合有一定Rust基础的开发者

1. **第1-2周**: 高级特性 (第13-16章)
2. **第3-4周**: 实战应用 (第19-20章)
3. **第5-8周**: 区块链开发 (第21-24章)

### 🚀 专家路径 (4-6个月)
适合想要深入掌握Rust和区块链开发的开发者

1. **完整学习**: 所有章节 (第1-24章)
2. **项目实践**: 完成所有实战项目
3. **贡献代码**: 参与开源项目

## 🛠️ 开发工具推荐

### IDE/编辑器
- **VS Code** + rust-analyzer (推荐)
- **IntelliJ IDEA** + Rust插件
- **Vim/Neovim** + rust.vim
- **Emacs** + rust-mode

### 调试工具
- **GDB/LLDB**: 系统级调试
- **Valgrind**: 内存检查 (Linux)
- **cargo-flamegraph**: 性能分析

### 实用工具
```bash
# 安装常用工具
cargo install cargo-watch    # 文件变化自动重新编译
cargo install cargo-expand   # 宏展开
cargo install cargo-audit    # 安全审计
cargo install cargo-outdated # 依赖更新检查
```

## 📊 项目统计

- **总章节数**: 24章
- **代码示例**: 100+ 个可运行示例
- **实战项目**: 8个完整项目
- **代码行数**: 10,000+ 行
- **测试覆盖**: 90%+

## 🤝 贡献指南

我们欢迎所有形式的贡献！

### 如何贡献

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

### 贡献类型

- 🐛 **Bug修复**: 修复代码错误或文档错误
- ✨ **新功能**: 添加新的示例或章节
- 📝 **文档改进**: 改进说明文档或注释
- 🎨 **代码优化**: 提高代码质量或性能
- 🌐 **翻译**: 翻译成其他语言

详细信息请查看 [贡献指南](CONTRIBUTING.md)

## 📄 许可证

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

## 🙏 致谢

感谢以下项目和社区的支持：

- [Rust官方文档](https://doc.rust-lang.org/)
- [Rust by Example](https://doc.rust-lang.org/rust-by-example/)
- [The Rust Programming Language Book](https://doc.rust-lang.org/book/)
- [Rustlings](https://github.com/rust-lang/rustlings)

## 📞 联系我们

- **GitHub Issues**: [提交问题](https://github.com/your-username/rust-blockchain-tutorial/issues)
- **讨论区**: [GitHub Discussions](https://github.com/your-username/rust-blockchain-tutorial/discussions)
- **邮箱**: rust-tutorial@example.com

## 🌟 Star History

如果这个项目对你有帮助，请给我们一个 ⭐️！

[![Star History Chart](https://api.star-history.com/svg?repos=your-username/rust-blockchain-tutorial&type=Date)](https://star-history.com/#your-username/rust-blockchain-tutorial&Date)

---

<div align="center">

**[开始学习](基础部分/01-rust入门/) | [查看示例](examples/) | [贡献代码](CONTRIBUTING.md)**

Made with ❤️ by Rust学习社区

</div>