5 分钟上手 StaticScript：从安装到编译出你的第一个原生可执行程序

5 分钟上手 StaticScript：从安装到编译出你的第一个原生可执行程序

【免费下载链接】StaticScript:rocket: TypeScript compiler on top of TypeScript as frontend and LLVM as backend项目地址: https://gitcode.com/gh_mirrors/sta/StaticScript

StaticScript 是一个基于 TypeScript 前端 + LLVM 后端的开源编译器，它能把 TypeScript 代码直接编译成原生可执行程序，无需 Node.js 运行时。如果你是 JS/TS 开发者，想尝试编写高性能的原生应用，这篇 StaticScript 入门教程就是为你准备的——只需 5 分钟，你就能跑通从安装、编写到编译出第一个可执行文件的全过程。

什么是 StaticScript？TypeScript 编译器的新玩法

简单来说，StaticScript 是一条"加速通道"：它复用 TypeScript 作为前端（负责语法解析与类型检查），再借助 LLVM 作为后端（负责优化与机器码生成），最终产出.ts→ LLVM IR → 字节码 → 目标文件 → 原生可执行程序的完整链路。编译流程的核心逻辑可以查看 src/cli.ts，整个流水线一目了然。

与常规的 TS → JS 转译不同，StaticScript 编译出的程序是真正的二进制文件，启动速度快、无解释器依赖，非常适合对性能敏感的场景。

StaticScript 安装教程：最快的配置方法

先确认环境里已具备 LLVM 工具链（llvm-opt、llvm-llc）以及c++编译器，然后打开终端执行一条命令即可完成全局安装：

npm install -g static-script

安装成功后，命令行就多了一个编译命令ssc。你也可以通过git clone https://gitcode.com/gh_mirrors/sta/StaticScript获取完整源码，本地执行npm install && npm run build从源码构建，编译入口同样在 src/cli.ts 的ssc命令中。

3 步写出你的第一个 StaticScript 程序

第一步：创建源码文件hello.ts，内容如下（示例参考 packages/hello-world/src/hello.ts）：

{ puts("Hello World!"); }

注意顶层用{}包裹语句块，这是 StaticScript 的书写约定。

第二步：编译，在项目目录执行：

ssc hello.ts

第三步：运行，编译产物默认输出到output/main：

./output/main

屏幕上就会打印出Hello World!🎉 至此，你的第一个由 TypeScript 编译而来的原生可执行程序就诞生了。

StaticScript 编译命令详解：常用参数一览

ssc提供了几个实用选项，帮你更好地控制编译过程：

参数	作用
-f, --outputFile <n>	指定可执行文件名，默认main
-o, --optimizationLevel <n>	优化级别，默认 3（最高优化）
--printIR	打印生成的 LLVM IR，适合学习编译原理
--debug	输出各阶段调试信息

想窥探编译器内部？执行ssc hello.ts --printIR，就能看到 TypeScript 代码翻译成 LLVM IR 的中间形态，非常直观。

进阶示例：用 StaticScript 计算圆周率

光有 Hello World 还不够，试试真正的算法。把下面这段蒙特卡洛法计算 π 的代码保存为calculate-pi.ts（参考 sandbox/do-simple-math.ts）：

{ function calculatePI(cycles: number): number { let inside = 0; for (let i = 0; i < cycles; i++) { let x = Math.random() * 2 - 1; let y = Math.random() * 2 - 1; if ((x*x + y*y) < 1) { inside++ } } return 4.0 * inside / cycles; } console_log(calculatePI(1000000000)); }

编译运行后，你能在毫秒级时间内得到接近 3.14 的结果，感受到原生二进制在执行密集循环时的速度优势。更多官方示例可以在 tests/snapshots/examples 和 tests/snapshots/general 中找到，涵盖循环、分支、类、数组、typeof 等特性。

StaticScript 现状：它能做什么，边界在哪里？

目前 StaticScript 已支持if/else、for/while/do、函数、数组（含Int32Array等类型化数组）、类、typeof 等常用语法，运行时内置了puts、console_log、Math数学库，类型声明见 staticscript.d.ts 与 packages/runtime/lib.runtime.d.ts。

需要注意的是，它还不支持完整的 DOM/BOM 及全部 JS 标准库——毕竟它的目标是原生执行而非浏览器环境。作为实验性项目，StaticScript 更适合用来探索"TS 直通原生"的编译思路，或作为学习 LLVM 后端的绝佳范例。

写在最后

从npm install -g static-script到跑通第一个原生程序，整个过程真的只需 5 分钟。StaticScript 把 TypeScript 的优雅语法与 LLVM 的强大优化能力结合在了一起，为前端开发者打开了一扇通往原生编译世界的大门。现在就去写一个你自己的.ts文件，体验把 TypeScript 编译成二进制程序的乐趣吧！

【免费下载链接】StaticScript:rocket: TypeScript compiler on top of TypeScript as frontend and LLVM as backend项目地址: https://gitcode.com/gh_mirrors/sta/StaticScript