Tengo: Golang 字节码编译脚本语言插件库

Tengo 是一个用 Go 编写的轻量级、可嵌入的脚本语言，它编译为字节码并在虚拟机上运行。Tengo 的设计目标是简单、高效且易于集成到 Go 应用程序中。

主要特性

• 轻量级且快速
• 动态类型
• 类 C 语法
• 可扩展性
• 内存安全
• 支持闭包
• 编译为字节码

基本用法

安装

go get github.com/d5/tengo/v2

简单示例

package main

import (
	"fmt"
	"github.com/d5/tengo/v2"
)

func main() {
	// 创建脚本
	script := tengo.NewScript([]byte(`
		// Tengo 代码
		text := "Hello, Tengo!"
		number := 42
		result := text + " " + number
	`))

	// 运行脚本
	compiled, err := script.Run()
	if err != nil {
		panic(err)
	}

	// 获取结果
	result := compiled.Get("result")
	fmt.Println(result.String()) // 输出: Hello, Tengo! 42
}

高级功能

1. 调用 Go 函数

package main

import (
	"fmt"
	"github.com/d5/tengo/v2"
)

func main() {
	script := tengo.NewScript([]byte(`
		// 调用 Go 函数
		greet("Tengo")
	`))

	// 定义 Go 函数
	greet := tengo.UserFunction{
		Name: "greet",
		Value: func(args ...tengo.Object) (tengo.Object, error) {
			name := args[0].(*tengo.String).Value
			return &tengo.String{Value: fmt.Sprintf("Hello, %s!", name)}, nil
		},
	}

	// 添加函数到脚本
	_ = script.Add("greet", &greet)

	compiled, err := script.Run()
	if err != nil {
		panic(err)
	}

	fmt.Println(compiled.Get("greet").String())
}

2. 使用模块

package main

import (
	"fmt"
	"github.com/d5/tengo/v2"
	"github.com/d5/tengo/v2/stdlib"
)

func main() {
	script := tengo.NewScript([]byte(`
		math := import("math")
		sqrt := math.sqrt
		result := sqrt(16)
	`))

	// 添加标准库模块
	modules := stdlib.GetModuleMap("math")
	script.SetImports(modules)

	compiled, err := script.Run()
	if err != nil {
		panic(err)
	}

	fmt.Println(compiled.Get("result").String()) // 输出: 4
}

3. 错误处理

package main

import (
	"fmt"
	"github.com/d5/tengo/v2"
)

func main() {
	script := tengo.NewScript([]byte(`
		// 故意制造错误
		undefinedFunc()
	`))

	_, err := script.Run()
	if err != nil {
		// 获取运行时错误
		if runtimeErr, ok := err.(*tengo.RuntimeError); ok {
			fmt.Printf("Runtime error: %s at line %d\n", 
				runtimeErr.Message, 
				runtimeErr.Traceback[0].Line)
		} else {
			fmt.Printf("Compile error: %v\n", err)
		}
	}
}

性能优化技巧

1. 复用脚本对象：对于频繁执行的脚本，可以预编译并复用

script := tengo.NewScript([]byte(`...`))
compiled, err := script.Compile()
if err != nil {
	panic(err)
}

// 多次执行
for i := 0; i < 100; i++ {
	_, err := compiled.Run()
	if err != nil {
		panic(err)
	}
}

1. 限制执行时间：防止无限循环

script := tengo.NewScript([]byte(`while true {}`))
script.SetMaxAllocs(10000) // 限制分配次数

_, err := script.Run()
if err != nil {
	fmt.Println("Execution stopped:", err)
}

实际应用场景

1. 配置解析：动态解析用户提供的配置
2. 规则引擎：执行用户定义的业务规则
3. 插件系统：允许用户扩展应用程序功能
4. 模板引擎：动态生成内容
5. 教育工具：教授编程概念

总结

Tengo 为 Go 应用程序提供了一个强大而灵活的脚本解决方案。它的轻量级设计和简单 API 使得集成变得非常容易，同时提供了足够的表达能力来处理复杂的脚本需求。无论是简单的表达式求值还是复杂的业务逻辑，Tengo 都能胜任。

更多高级功能和详细文档可以参考 Tengo 官方 GitHub 仓库。