Anko - Go语言的脚本化解释器插件库

Anko 是一个用 Go 语言编写的轻量级脚本引擎/解释器，它允许你在 Go 程序中嵌入脚本功能。Anko 的主要特点是简单易用、性能良好，并且与 Go 语言有很好的互操作性。

主要特性

1. 支持 Go 语言类似的语法
2. 可以直接调用 Go 函数和变量
3. 轻量级，易于集成
4. 支持模块化加载
5. 良好的错误处理机制

基本使用示例

安装 Anko

go get github.com/mattn/anko/vm

简单示例

package main

import (
	"fmt"
	"github.com/mattn/anko/vm"
)

func main() {
	env := vm.NewEnv()

	// 执行简单脚本
	script := `
a = 1 + 2
b = a * 3
println("结果:", b)
`
	_, err := env.Execute(script)
	if err != nil {
		fmt.Println("执行错误:", err)
	}
}

与 Go 代码交互

package main

import (
	"fmt"
	"github.com/mattn/anko/vm"
)

func add(a, b int) int {
	return a + b
}

func main() {
	env := vm.NewEnv()

	// 注册Go函数到脚本环境
	err := env.Define("add", add)
	if err != nil {
		fmt.Println("定义函数失败:", err)
		return
	}

	// 在脚本中调用Go函数
	script := `
result = add(3, 4)
println("3 + 4 =", result)
`
	_, err = env.Execute(script)
	if err != nil {
		fmt.Println("执行错误:", err)
	}
}

处理脚本返回值

package main

import (
	"fmt"
	"github.com/mattn/anko/vm"
)

func main() {
	env := vm.NewEnv()

	script := `
func multiply(a, b) {
	return a * b
}

multiply(5, 6)  // 最后一行表达式的值会被返回
`

	value, err := env.Execute(script)
	if err != nil {
		fmt.Println("执行错误:", err)
		return
	}

	fmt.Println("脚本返回值:", value) // 输出: 脚本返回值: 30
}

模块化使用

package main

import (
	"fmt"
	"github.com/mattn/anko/vm"
)

func main() {
	env := vm.NewEnv()

	// 定义模块A
	moduleA := `
module A {
	func greet(name) {
		return "Hello, " + name
	}
}
`
	_, err := env.Execute(moduleA)
	if err != nil {
		fmt.Println("加载模块A失败:", err)
		return
	}

	// 使用模块A中的函数
	script := `
import A
message = A.greet("World")
println(message)
`

	_, err = env.Execute(script)
	if err != nil {
		fmt.Println("执行错误:", err)
	}
}

高级用法

自定义类型交互

package main

import (
	"fmt"
	"github.com/mattn/anko/vm"
)

type Person struct {
	Name string
	Age  int
}

func (p *Person) Greet() string {
	return fmt.Sprintf("I'm %s, %d years old", p.Name, p.Age)
}

func main() {
	env := vm.NewEnv()

	// 注册自定义类型
	err := env.Define("Person", &Person{})
	if err != nil {
		fmt.Println("定义类型失败:", err)
		return
	}

	script := `
p = Person()
p.Name = "Alice"
p.Age = 25
println(p.Greet())
`

	_, err = env.Execute(script)
	if err != nil {
		fmt.Println("执行错误:", err)
	}
}

错误处理

package main

import (
	"fmt"
	"github.com/mattn/anko/vm"
)

func main() {
	env := vm.NewEnv()

	script := `
func divide(a, b) {
	if b == 0 {
		error("除数不能为零")
	}
	return a / b
}

result = divide(10, 0)
println(result)
`

	_, err := env.Execute(script)
	if err != nil {
		fmt.Println("捕获到脚本错误:", err)
	}
}

性能考虑

对于频繁调用的脚本，可以考虑预编译：

package main

import (
	"fmt"
	"github.com/mattn/anko/parser"
	"github.com/mattn/anko/vm"
)

func main() {
	env := vm.NewEnv()

	script := `
func fib(n) {
	if n <= 1 {
		return n
	}
	return fib(n-1) + fib(n-2)
}
`

	// 预编译脚本
	stmts, err := parser.ParseSrc(script)
	if err != nil {
		fmt.Println("解析错误:", err)
		return
	}

	// 执行预编译的脚本
	_, err = env.Execute(stmts)
	if err != nil {
		fmt.Println("执行错误:", err)
		return
	}

	// 多次调用编译好的函数
	for i := 0; i < 10; i++ {
		value, err := env.Execute("fib(" + fmt.Sprint(i) + ")")
		if err != nil {
			fmt.Println("执行错误:", err)
			continue
		}
		fmt.Printf("fib(%d) = %v\n", i, value)
	}
}

使用场景建议

1. 需要动态配置的业务规则
2. 插件系统实现
3. 用户自定义脚本功能
4. 快速原型开发
5. 教育目的（教授编程概念）

限制

1. 不是完整的Go语言实现
2. 性能不如原生Go代码
3. 某些高级Go特性不支持
4. 错误信息有时不够详细

Anko 是一个强大而灵活的工具，特别适合需要在Go应用程序中添加脚本功能的场景。它的简单API和与Go的良好互操作性使其成为许多项目的理想选择。