Node.js中如何无需显式导入即可为DSL提供预定义函数？

当然有办法实现，针对Node.js的不同模块系统（CommonJS/ESM），可以用以下几种方案：

方案1：利用global对象（CommonJS模块场景） #

Node.js的CommonJS模块环境里有全局的global对象，把预定义函数挂载到这个对象上后，所有CommonJS模块都能直接访问这些函数，无需手动导入。

步骤如下：

1. 编写启动/预加载脚本bootstrap.js：

// 导入你的内置函数
const { doStuff, makeFoo } = require('./builtins');
// 挂载到global对象
global.doStuff = doStuff;
global.makeFoo = makeFoo;

// 加载你的DSL脚本
require('./dsl_script.js');

2. 运行启动脚本：

node bootstrap.js

此时dsl_script.js里的doStuff(1,2)和makeFoo()就能直接执行。

方案2：用--require（-r）参数预加载全局函数 #

如果不想写单独的启动脚本，可借助Node.js的-r参数预加载一个模块，在这个模块里完成函数的全局挂载。

1. 创建预加载脚本preload.js：

const { doStuff, makeFoo } = require('./builtins');
global.doStuff = doStuff;
global.makeFoo = makeFoo;

2. 直接运行DSL脚本并带上预加载参数：

node -r ./preload.js dsl_script.js

方案3：ESM模块场景下的处理 #

如果你的DSL脚本采用ES模块（比如package.json里设置了"type": "module"），CommonJS的global对象不可用，但可以用标准的globalThis对象替代。

1. 编写ESM格式的预加载脚本preload.mjs：

import { doStuff, makeFoo } from './builtins.mjs';
globalThis.doStuff = doStuff;
globalThis.makeFoo = makeFoo;

2. 运行命令：

node -r ./preload.mjs dsl_script.mjs

方案4：自定义模块加载器（更可控的DSL场景） #

如果想避免全局变量冲突，同时更灵活地控制DSL脚本的加载过程，可以用Node.js的自定义模块加载器，在加载DSL脚本时自动注入导入语句，或者修改模块的执行上下文。

比如编写加载器dsl-loader.mjs：

import { readFile } from 'fs/promises';
import { pathToFileURL } from 'url';

export async function load(url, context, defaultLoad) {
  // 只处理我们的DSL脚本，通过扩展名识别
  if (url.endsWith('.dsl.js')) {
    // 读取原脚本内容
    const source = await readFile(new URL(url), 'utf8');
    // 自动注入导入语句
    const modifiedSource = `import { doStuff, makeFoo } from './builtins.mjs';\n${source}`;
    // 返回修改后的代码让Node执行
    return {
      format: 'module',
      source: modifiedSource,
    };
  }
  // 其他文件沿用默认加载逻辑
  return defaultLoad(url, context, defaultLoad);
}

运行时指定加载器：

node --loader ./dsl-loader.mjs your-script.dsl.js

这种方式下，用户编写的DSL脚本完全不用添加导入语句，加载器会在后台自动处理，同时不会污染全局环境。

注意事项 #

• 全局挂载类方案（1-3）存在变量冲突风险，若开发通用DSL，优先选择自定义加载器方案更安全。
• 需明确你的DSL脚本是CommonJS还是ESM格式，两种场景的处理方式略有差异。

内容的提问来源于stack exchange，提问作者Rob N