构建系统概览

ReScript 自带一个快速且精简的构建系统 rescript,它被用作社区的权威构建系统。

每个 ReScript 项目都需要一个构建描述文件,即 bsconfig.json

构建选项

通过 rescript -help 查看构建选项:

❯ rescript -help Available flags -v, -version display version number -h, -help display help Subcommands: build clean format convert help Run rescript subcommand -h for more details, For example: rescript build -h rescript format -h The default `rescript` is equivalent to `rescript build` subcommand

构建项目

每次构建都会从你的项目的源文件中创建构建制品(artifacts)。

使用以下命令来构建一个项目(包括其依赖/固定依赖)

SH
rescript

这是 rescript build 的一个别名。

使用以下命令以 watch 模式启动构建:

SH
rescript build -w

这样任何的文件变化都会被捕捉到,并重新开始构建。

注意:第三方库(指在 node_modules 中的库或 pinned-dependencies 引入的库)不会被监听,因为这样做可能超过 node.js 的监听器数量限制。

注意2: 如果你想以 JS-monorepo-esque 的方式(npmyarn 工作区)建立一个项目,你的子包的变化应该被构建工具注意到,你需要在主项目的 bsconfig.json 中定义固定依赖。更多细节参见这里

清理项目

如果你因为边缘情况需要处理过时的构建,可以使用:

SH
rescript clean

这将清空你的项目的构建制品。要清理依赖项的构建制品,可以使用:

SH
rescript clean -with-deps