词法分析 → 字节码 VM → 单二进制交付

用 Go 从零实现的
JavaScript 运行时

自研 lexer / parser / compiler / 栈式虚拟机,完整走通一条编译管线。 单二进制、零外部依赖,自带 GUI 渲染层,还能把 JS 脚本打包成独立可执行文件。

gox — REPL / 运行脚本 / 创建工程
$ npm i -g @goxjs/goxjs $ gox Gox REPL (ES6 subset, no var) Type :exit to quit, :help for help > let x = 10 > let y = 20 > x + y 30 > [1, 2, 3].map(v => v * 2) [2, 4, 6] >
109个操作码
3 字节定长指令编码
25个内置 GUI 元素
5 平台npm 预编译二进制

它到底是什么

一句话说清定位,省得你在文档里翻半天。

是什么

一个用 Go 写的、从词法分析到字节码虚拟机全部自己实现的 JavaScript 运行时。不是 V8 的绑定,也不是把 JS 翻译成 Go。

能做什么

跑 ES6+ 脚本、写 CLI 工具、写带窗口的桌面程序、把脚本打包成单个可执行文件发给别人,以及拿它学运行时原理。

不做什么

不追求替代生产环境的 Node 生态:没有 npm 兼容、没有 require、没有 JIT,也不实现 DOM。当作一门独立的小语言 + 自带 UI 框架来用。

为什么是 Gox

不是又一层封装,而是从 Token 到虚拟机的每一层都自己写。

⚙️

完整编译管线

自研 lexer / parser / compiler / 字节码 VM,109 个操作码,定长 3 字节指令 [op 1B][operand 2B],解码即取即用。

✨

ES6+ 语言子集 + JSX

闭包、class、async/await、解构、模板字符串、可选链、空值合并、ES 模块;JSX 在编译期降级为 h() 调用。

📦

丰富的内置对象

Array / String / Map / Set / Symbol / BigInt / RegExp / Proxy / Promise / TypedArray / Temporal 等现代 JS 标准库。

🔌

宿主能力模块

Node 风格的 fs(同步 + 异步)、http 客户端与服务端、全局 fetch、path、process —— 全部挂在全局,免 import。

🖥️

自研 GUI 渲染层

纯 Go 软件光栅化 + flex/网格布局(百分比、圆角、渐变、阴影)+ 脏矩形局部重绘,win32 与 X11 后端,产物为无动态库依赖的静态单文件。

🧩

25 个内置 GUI 元素

按钮 / 勾选 / 单选 / 开关 / 输入框 / 多行编辑 / 下拉框 / 滑块 / 滚动容器 / 图片 / 画布 / 对话框 / 提示 / 菜单栏 / 右键菜单 / 进度条 / 分隔线 / 占位 / 通用盒子 / 栅格 / 窗口 —— 全部受控语义,配套组件参考手册。

🧭

路由与屏幕

gx/router 提供路由表、:param 匹配、三级守卫、历史栈、懒加载、多窗口作用域;gx/screen 提供显示器枚举与折叠姿态,半折屏自动双栏。

🛠️

脚手架 + 单文件打包

gox create my-app 一条命令铺出可跑工程;packager 把脚本嵌入生成的 Go 工程,编成单文件程序,目标机无需装任何运行时。

💾

本地持久化

gx/storage 提供应用级键值存储,值经 JSON 序列化落盘到系统应用数据目录,同步 API,写穿透立即生效。

能力总览

一张表找到所有能力,以及每一块该去哪个页面看。

层面内容去哪看
语言 ES6+ 子集:let/const、箭头函数、class、async/await、解构、展开、模板字符串、可选链、空值合并、ES 模块、JSX 教程 §3
标准库 Object / Array / String / Number / Boolean / Symbol / BigInt / Math / JSON / RegExp / Map / Set / WeakMap / WeakSet / Proxy / Reflect / Promise / ArrayBuffer / TypedArray / DataView / Temporal … API §3
宿主模块
全局,免 import
console / fs / path / process / http / fetch API §6
响应式 全局 obs / computed / ever / once(GetX 风格),以及 gx/solid 的 createSignal 家族(SolidJS 风格) 教程 §9
GUI 25 个内置元素 + JSX + 脏矩形局部重绘;布局、受控语义、事件、层叠、过渡动画、多窗口 组件参考
内置模块
需 import
gx/solid · gx/gfx · gx/view · gx/router · gx/screen · gx/dialog · gx/storage · gx/dev · gx/device · gx/app · gx/geo · gx/media · gx/permission · gx/viewport,以及聚合入口 gox API §7
工具链 gox / goxjs 命令行(REPL、运行脚本、create 脚手架)、packager 打包单文件、五平台 npm 预编译二进制 教程 §1

文档

三条主线:先学怎么用,再查界面组件,最后核对 API 细节。

快速开始

三种进入方式,按你的目标挑一个。

方式一:脚手架建工程推荐
npm i -g @goxjs/goxjs
gox create my-app
cd my-app
npm install
npm start
方式二:npm 装运行时无需 Go 环境
npm i -g @goxjs/goxjs   # 内置 5 平台预编译二进制
gox                 # 进入 REPL
gox app.js          # 运行脚本
npx goxjs app.js    # 不安装直接跑
方式三:从源码构建Go 1.26+
git clone https://github.com/14752222/Gox.git
cd Gox
go build            # Windows 下生成 Gox.exe
./Gox app.js

写起来就是 JavaScript

左边是语言能力,右边是一个 16 行的响应式 GUI 桌面应用 —— 点击按钮计数,只重绘受影响区域。

语言与宿主能力
// ES6+ 子集(let/const,不支持 var)
let [a, b] = [1, 2];
console.log(`${a + b}`);            // 3

// class / async / await
class Point {
  constructor(x, y) { this.x = x; this.y = y }
  norm() { return Math.hypot(this.x, this.y) }
}

async function main() {
  let v = await delay(10, "timer done");
  console.log(v);
}

// fs / http / fetch / process 全局可用
let cfg = fs.readFileSync("app.json", "utf-8");
let res = await fetch("https://example.com/api");
GUI 桌面应用(counter.js)
import { createSignal } from "gx/solid";
import { h, render } from "gx/gfx";

const [count, setCount] = createSignal(0);

render(
  <window title="Counter" width={400} height={300}>
    <column gap={8} padding={16}>
      <text font={20}>{() => `count: ${count()}`}</text>
      <button onClick={() => setCount(c => c + 1)}>加一</button>
    </column>
  </window>
);

// gox counter.js      → 弹出 400x300 窗口
// go run ./packager counter.js --gui -o counter.exe
//   → 打包成独立 GUI 程序

架构

一条清晰的编译管线,每一层都可以单独阅读和测试。

.js 源码UTF-8 文本
→
lexer词法分析 → Token 流
→
parser语法分析 → AST
→
compiler符号表 + 字节码生成
→
vm栈式帧执行 + 事件循环

无 GC 的显式内存管理

对象生命周期由运行时显式控制,循环引用有专门处理,不依赖 Go 的垃圾回收器托管 JS 堆。

单线程 VM + 跨 goroutine 调度

http.createServer 等网络回调跨 goroutine 捕获后调度回 VM 单线程执行,无需锁。

版本与现状

当前版本 0.5.0。下面是最近几个版本真正加了什么,详细条目见 GitHub Releases。

版本内容
0.5.0 原生能力层:六个内置模块 gx/device · gx/app · gx/geo · gx/media · gx/permission · gx/viewport(共用一个宿主契约);padding 支持四边分别指定
0.4.0 脚手架 gox create(并新增 gox 命令别名);路由 gx/router 与屏幕 gx/screen 成为内置模块
0.4.1 修字形缓存别名 bug —— 曾经让整屏汉字在重绘后显示成同一个字
0.4.2 修 <text> 内容被绘制两遍(重影)
0.4.3 font 改为沿父链继承(<button font={13}> 标签现在按 13 号测量与绘制)
已知缺口

macOS 的 GUI 后端尚未实现(CLI 不受影响);X11 后端已实现但未做实机验证;虚拟化长列表、表格、tooltip、图标、富文本等仍未封装;原生能力层里依赖真机的部分(相机 / 定位 / 相册 / 权限)在桌面上诚实报 unsupported,需移动宿主实现。 组件级的详细支持现状见组件参考。

二十五个内置元素,拿来就用

从布局容器到菜单栏,每个元素都有完整的功能说明、参数表与可运行示例。

查看组件参考 →

十分钟跑起来第一个脚本

从安装、脚手架、REPL、模块、异步到打包独立可执行文件,一步步走。

阅读使用教程 →