安装运行

ClojureScript 的编译依赖 Java, 后来逐渐完成了 JavaScript 实现的 Self-hosted ClojureScript, 也就是能在 JavaScript 环境当中直接编译 ClojureScript.

这份文档当中使用 Lumo 作为 REPL 和脚本的执行工具, 使用 shadow-cljs 作为项目的建构工具.

Lumo

一个基于 Self-hosted ClojureScript 开发的运行在 V8 的环境 https://github.com/anmonteiro/lumo

brew install lumo

Lumo 借助 V8 的 Snapshot 特性优化了启动速度. 同时支持在运行时引用 npm 模块. 后来 Lumo 也加入了 ClojureScript 建构的功能.

它的使用体验类似 node, 可以直接启动 REPL:

$ lumo
Lumo 1.8.0
ClojureScript 1.9.946
Node.js v9.2.0
 Docs: (doc function-name-here)
       (find-doc "part-of-name-here")
 Source: (source function-name-here)
 Exit: Control+D or :cljs/quit or exit

cljs.user=> (println "demo")
demo
nil
cljs.user=>

也可以用 Lumo 运行脚本, 比如 demo.cljs 文件:

(println "this is a demo")
(println (+ 1 2))
(def a 1)
(println a)

可以命令运行执行:

lumo demo.cljs

Lumo 和 Clojure 一样, 依赖 classpaths 来查找依赖, classpaths 可以是路径或者是 jar 包. 在 Clojure 中可以查看:

clj -Spath
src:/Users/chen/.m2/repository/org/clojure/clojure/1.9.0/clojure-1.9.0.jar:/Users/chen/.m2/repository/org/clojure/spec.alpha/0.1.143/spec.alpha-0.1.143.jar:/Users/chen/.m2/repository/org/clojure/core.specs.alpha/0.1.24/core.specs.alpha-0.1.24.jar

可以看到 src/ 是默认在搜索路径当中的, 对于 Lumo 使用 classpath 可以这样配合:

lumo -c `clj -Spath`

shadow-cljs

shadow-cljs 是专为 ClojureScript 开发定制的精简的编译器, 提供了一些对非 Java 用户而言相对友好的功能 https://github.com/thheller/shadow-cljs

可以通过 npm 直接安装:

npm install -g shadow-cljs

shadow-cljs 使用 shadow-cljs.edn 作为配置文件, 比如:

{:source-paths ["src"]
 :dependencies []
 :builds {:app {:output-dir "target/"
                :asset-path "."
                :target :browser
                :modules {:main {:entries [app.main]}}
                :devtools {:after-load app.main/reload!}}}}

运行 watch 子命令的表示启动开发环境, 同时监视 src/ 目录中的代码改变, 激活热替换功能:

shadow-cljs watch app

运行 release 子命令可以编译优化整个项目:

shadow-cljs release app

这里的 app 对应配置当中的 build-id :app.

shadow-cljs 运行中需要 Java 环境, 需要保证在系统当中安装 Java:

http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

通过 clj 启动

最新版本的 ClojureScript 完善了对 clj 命令的支持, 基于 deps.edn 文件的依赖:

{:deps {org.clojure/clojurescript {:mvn/version "1.10.238"}}}

能够从命令行直接启动 cljs 代码, 打开一个 REPL:

clj --main cljs.main --repl

具体步骤参考官网的 Guide 操作 https://clojurescript.org/guides/quick-start

其他方案

其他的 REPL 环境还有 planck. 其他 cljs 编译方案也有基于 Boot, Lein, 甚至也可以直接调用 Java API 进行编译. 如果需要, 可以查询相关资料尝试.