QuickJS 项目教程

QuickJS 项目教程

quickjs Public repository of the QuickJS Javascript Engine. Pull requests are not accepted. Use the mailing list to submit patches. 项目地址: https://gitcode.com/gh_mirrors/qu/quickjs

1. 项目的目录结构及介绍

QuickJS 项目的目录结构如下：

quickjs/
├── doc/
│   ├── quickjs.pdf
│   └── quickjs.html
├── examples/
├── fuzz/
├── tests/
├── github/workflows/
├── compat/
├── cutils/
│   ├── cutils.c
│   └── cutils.h
├── libbf/
│   ├── libbf.c
│   └── libbf.h
├── libregexp/
│   ├── libregexp.c
│   └── libregexp.h
├── libunicode/
│   ├── libunicode.c
│   └── libunicode.h
├── qjs/
│   ├── qjs.c
│   └── qjs.h
├── qjsc/
│   └── qjsc.c
├── quickjs-libc/
│   ├── quickjs-libc.c
│   └── quickjs-libc.h
├── repl/
│   └── repl.js
├── run-test262/
│   └── run-test262.c
├── test262/
│   ├── conf
│   └── test262_errors.txt
├── unicode_gen/
│   ├── unicode_gen.c
│   └── unicode_gen_def.h
├── .gitignore
├── Changelog
├── LICENSE
├── Makefile
├── TODO
├── VERSION
├── README.txt
└── release.sh

目录介绍：

• doc/: 包含 QuickJS 的主要文档，包括 PDF 和 HTML 格式的文档。
• examples/: 包含 QuickJS 的使用示例。
• fuzz/: 包含用于模糊测试的文件。
• tests/: 包含 QuickJS 的测试文件。
• github/workflows/: 包含 GitHub Actions 的工作流配置文件。
• compat/: 包含与兼容性相关的文件。
• cutils/: 包含一些通用的 C 工具函数。
• libbf/: 包含位字段库的实现。
• libregexp/: 包含正则表达式库的实现。
• libunicode/: 包含 Unicode 库的实现。
• qjs/: 包含 QuickJS 引擎的核心实现。
• qjsc/: 包含 QuickJS 编译器的实现。
• quickjs-libc/: 包含 QuickJS 的标准库实现。
• repl/: 包含交互式解释器的实现。
• run-test262/: 包含测试 ECMAScript 262 标准的实现。
• test262/: 包含 ECMAScript 262 标准的测试文件。
• unicode_gen/: 包含 Unicode 生成工具的实现。
• .gitignore: Git 忽略文件。
• Changelog: 项目变更日志。
• LICENSE: 项目许可证。
• Makefile: 项目构建文件。
• TODO: 项目待办事项。
• VERSION: 项目版本号。
• README.txt: 项目简介。
• release.sh: 发布脚本。

2. 项目的启动文件介绍

QuickJS 项目的启动文件是 qjs/qjs.c。这个文件是 QuickJS 引擎的核心实现，负责初始化引擎并执行 JavaScript 代码。

主要功能：

• 初始化引擎: 启动时初始化 QuickJS 引擎。
• 执行 JavaScript 代码: 从命令行或文件中读取 JavaScript 代码并执行。
• 提供 REPL 模式: 支持交互式解释器模式，允许用户直接输入 JavaScript 代码并立即执行。

3. 项目的配置文件介绍

QuickJS 项目的主要配置文件是 Makefile。这个文件定义了项目的构建规则和依赖关系。

主要配置项：

• 编译选项: 定义了编译器选项和链接器选项。
• 目标文件: 定义了需要生成的目标文件和可执行文件。
• 依赖关系: 定义了各个源文件之间的依赖关系。
• 构建规则: 定义了如何从源文件生成目标文件的规则。

通过修改 Makefile，用户可以自定义编译选项、添加新的源文件或修改现有的构建规则。

quickjs Public repository of the QuickJS Javascript Engine. Pull requests are not accepted. Use the mailing list to submit patches. 项目地址: https://gitcode.com/gh_mirrors/qu/quickjs