goja 不支持 es6+ 的 import 语法和模块系统，需通过自定义 require 函数手动加载本地 js 文件，本文详解如何在 go 环境中为 goja 注入模块加载能力，并安全执行含依赖的 js 脚本。
goja 不支持 es6+ 的 import 语法和模块系统，需通过自定义 require 函数手动加载本地 js 文件，本文详解如何在 go 环境中为 goja 注入模块加载能力，并安全执行含依赖的 js 脚本。
Goja 是一个纯 Go 实现的 ECMAScript 5.1 兼容 JavaScript 运行时，不支持 import/export、ES 模块解析、Node.js 的 require() 或任何动态模块加载机制。当你尝试运行包含 import * as functions from './formula.js' 的代码时，Goja 会直接报语法错误（Unexpected token 'import'），因为该语法在 ES5.1 中不存在。
要解决这一限制，核心思路是：用 Go 实现一个符合 CommonJS 风格的 require 函数，并将其注入 Goja 运行时全局作用域，由 Go 层负责读取、解析并执行依赖文件，再将导出值返回给 JS 上下文。
以下是一个生产就绪的实现方案：
✅ 步骤一：构建安全的 require 函数
package main
import (
"io/ioutil"
"os"
"path/filepath"
"github.com/dop251/goja"
)
// createRequire 返回一个可在 Goja 中调用的 require 函数
func createRequire(vm *goja.Runtime, baseDir string) func(string) goja.Value {
return func(modulePath string) goja.Value {
// 1. 解析绝对路径（支持相对路径，基于 baseDir）
absPath := filepath.Join(baseDir, modulePath+".js")
if !filepath.IsAbs(modulePath) {
absPath = filepath.Clean(absPath)
}
// 2. 检查文件是否存在且可读
if _, err := os.Stat(absPath); os.IsNotExist(err) {
panic(vm.NewTypeError("Module not found: " + modulePath + " (resolved to " + absPath + ")"))
}
// 3. 读取并执行模块代码
code, err := ioutil.ReadFile(absPath)
if err != nil {
panic(vm.NewTypeError("Failed to read module " + modulePath + ": " + err.Error()))
}
// 4. 在当前 VM 中执行（共享全局作用域，注意变量污染风险）
result, err := vm.RunString(string(code))
if err != nil {
panic(vm.NewError(err))
}
return result
}
}⚠️ 注意事项：
Alibabacloud Sdk Client Initialization For Java下载在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
立即学习“Java免费学习笔记（深入）”；
baseDir建议设为 JS 主文件所在目录（如./scripts），避免硬编码路径；- 使用
ioutil.ReadFile（Go 1.16+ 推荐改用os.ReadFile）；panic用于中断执行并抛出 Goja 可捕获的错误，便于上层统一处理；- 所有模块在*同一 `goja.Runtime
实例中执行**，因此var声明的顶层变量会相互影响——推荐模块使用module.exports = {...}或export default` 风格显式导出（见下文）。
✅ 步骤二：改造 JS 模块为 CommonJS 兼容格式
由于 Goja 不解析 export，你的 formula.js 和 lodash.js 必须显式导出对象，例如：
// formula.js
function add(a, b) { return a + b; }
function multiply(a, b) { return a * b; }
// ✅ 正确：CommonJS 风格导出（Goja 可识别）
module.exports = {
add,
multiply
};
// 或：exports.add = add; exports.multiply = multiply;// lodash.js（精简示例）
function get(obj, path, defaultValue) {
const keys = path.split('.');
let result = obj;
for (const key of keys) {
if (result == null || typeof result !== 'object') return defaultValue;
result = result[key];
}
return result === undefined ? defaultValue : result;
}
function cloneDeep(obj) {
return JSON.parse(JSON.stringify(obj));
}
// ✅ 显式导出
module.exports = { get, cloneDeep };✅ 步骤三：在主脚本中使用 require
func main() {
vm := goja.New()
scriptDir := "./" // 替换为实际 JS 文件所在目录
// 注入 require 函数
vm.Set("require", createRequire(vm, scriptDir))
// 主入口脚本（不再使用 import）
mainScript := `
const functions = require('./formula');
const { get, cloneDeep } = require('./lodash');
// 直接使用
const result = functions.add(2, 3);
const data = { a: { b: 42 } };
const val = get(data, 'a.b', 0);
// 导出结果供 Go 获取
result;
`
// 执行并获取返回值
value, err := vm.RunString(mainScript)
if err != nil {
panic("JS execution failed: " + err.Error())
}
// 在 Go 中读取 JS 返回值
if num, ok := goja.AssertFloat(value); ok {
fmt.Printf("JS returned number: %.0f\n", num) // 输出: 5
}
}✅ 进阶建议
-
避免全局污染：对每个模块使用独立
vm.NewContext()并手动绑定module.exports，但会增加复杂度；更推荐模块自身封装良好、无副作用。 -
缓存模块：在
createRequire中加入map[string]goja.Value缓存已加载模块，提升重复加载性能。 -
错误堆栈增强：用
vm.ToValue(map[string]interface{}{"filename": absPath})包装错误，辅助调试。 - 替代方案考虑：若项目重度依赖现代 JS 生态（如 TypeScript、NPM 包），建议改用 Otto（已归档）或通过 Node.js 子进程 + stdio 通信，而非强行在 Goja 中模拟模块系统。
通过以上方式，你就能在 Goja 中稳健地运行含多文件依赖的 JavaScript 逻辑，兼顾安全性、可维护性与执行效率。
