Skip to content

README_CN.md

Latest commit

 

History

History
184 lines (140 loc) · 4.59 KB

README_CN.md

File metadata and controls

184 lines (140 loc) · 4.59 KB

V8-RS 中文教程

本教程使用中文编写，帮助中文开发者理解 JavaScript 引擎的实现原理。

📖 教程说明

本教程通过实现一个简化版的 V8 JavaScript 引擎，带你深入理解：

  • 编译器前端（词法分析、语法分析）
  • 中间表示（字节码）
  • 虚拟机（解释器）
  • 系统集成

每个章节都包含：

  • ✅ 详细的原理讲解
  • ✅ 完整的代码示例
  • ✅ 设计决策分析
  • ✅ 常见问题解答
  • ✅ 练习题

🚀 快速开始

10 分钟快速上手： 快速开始指南

📚 教程章节

基础篇

章节 标题 内容 难度
1 项目初始化 Rust 项目配置、核心类型设计 ⭐
2 词法分析器 Token 设计、源码扫描 ⭐⭐
3 抽象语法树 AST 节点设计、树结构 ⭐⭐

进阶篇

章节 标题 内容 难度
4 递归下降解析器 表达式解析、优先级处理 ⭐⭐⭐
5 作用域系统 变量管理、作用域链 ⭐⭐
6 字节码指令集 指令设计、常量池 ⭐⭐
7 字节码生成器 AST 转换、控制流 ⭐⭐⭐

高级篇

章节 标题 内容 难度
8 解释器 虚拟机、指令执行 ⭐⭐⭐⭐
9 引擎集成 组件协调、流程控制 ⭐⭐⭐
10 总结与展望 回顾、优化、扩展 ⭐⭐

🎯 学习路线

路线 A：完整学习（推荐新手）

第1章 → 第2章 → 第3章 → 第4章 → 第5章 → 
第6章 → 第7章 → 第8章 → 第9章 → 第10章

时间： 2-3 周（每天 2-3 小时）

路线 B：核心重点（有基础）

第1章 → 第4章 → 第7章 → 第8章 → 第9章

时间： 1 周（每天 2-3 小时）

路线 C：快速浏览（了解原理）

第1章 → 第2章 → 第6章 → 第8章 → 第10章

时间： 2-3 天

💡 学习建议

1. 动手实践

# 克隆项目
git clone <repo-url>
cd v8-rs

# 运行测试
cargo test

# 运行示例
cargo run --example basic

2. 边学边写

  • 不要直接复制代码
  • 理解原理后自己实现
  • 对比你的实现和教程代码

3. 使用调试工具

// 添加调试输出
println!("Token: {:?}", token);
println!("AST: {:#?}", ast);
println!("Bytecode: {:?}", bytecode);

4. 完成练习

每章末尾都有练习题，建议完成：

  • ⭐ 基础练习：必做
  • ⭐⭐ 进阶练习：推荐
  • ⭐⭐⭐ 挑战练习：选做

📊 项目统计

代码行数：   ~3,000 行
测试代码：   ~1,000 行
文档：       ~5,000 行
测试用例：   67 个
通过率：     100%

🛠️ 技术栈

  • 语言： Rust 2021
  • 测试： quickcheck（属性测试）
  • 工具： cargo

📖 参考资料

中文资源

英文资源

❓ 常见问题

Q1: 需要什么基础？

A:

  • ✅ 必需：Rust 基础语法
  • ✅ 推荐：数据结构基础
  • ⭕ 可选：编译原理基础

Q2: 学完能做什么？

A:

  • 理解 JavaScript 引擎工作原理
  • 实现自己的脚本语言
  • 为开源编译器项目贡献
  • 深入学习 V8、SpiderMonkey 等

Q3: 遇到问题怎么办？

A:

  1. 查看章节的"常见问题"部分
  2. 运行测试查看错误信息
  3. 对比完整代码
  4. 提交 Issue 寻求帮助

Q4: 如何贡献？

A:

  • 🐛 报告文档错误
  • 💡 提出改进建议
  • 📝 补充示例代码
  • 🌏 改进中文表达

🎓 学习目标

完成本教程后，你将能够：

✅ 实现完整的词法分析器和语法分析器
✅ 设计字节码指令集
✅ 构建栈式虚拟机
✅ 理解作用域和变量管理
✅ 掌握 Rust 系统编程
✅ 编写高质量测试
✅ 设计可扩展架构

🚀 开始学习

准备好了吗？

  1. 新手： 从快速开始开始
  2. 有基础： 直接阅读第 1 章
  3. 快速浏览： 查看总结章节

祝学习愉快！有问题欢迎提 Issue。 🎉