如何在Node.js中为import.meta添加跨文件持久化的属性？

问题本质 #

每个ES模块的import.meta是模块专属的独立对象，在一个模块中修改import.meta的属性只会作用于当前模块，无法影响其他模块的import.meta实例，这就是你在a.mjs中拿不到b.mjs里设置的import.meta.env的核心原因。

可行解决方案：使用Node.js自定义加载器 #

通过自定义加载器，我们可以在模块编译阶段向所有ES模块注入import.meta.env的定义，让所有模块共享同一个环境配置对象，完全匹配Vite的import.meta.env.DEV格式。

方案1：静态注入固定环境配置

1. 创建加载器文件env-loader.mjs：

import { defaultLoad } from 'node:module';

export async function load(url, context, defaultLoad) {
  const result = await defaultLoad(url, context, defaultLoad);

  // 仅处理ES模块
  if (context.format === 'module') {
    // 注入全局环境配置
    const envConfig = JSON.stringify({ DEV: true });
    const modifiedSource = `
      import.meta.env = ${envConfig};
      ${result.source.toString()}
    `;
    return {
      source: modifiedSource,
      format: 'module'
    };
  }

  return result;
}

2. 简化业务模块代码：

// a.mjs
import './b.mjs';
console.log('[a.mjs] import.meta.env.DEV', import.meta.env?.DEV);

// b.mjs
console.log('[b.mjs] import.meta.env.DEV', import.meta.env.DEV);

3. 使用加载器运行代码：

node --experimental-loader ./env-loader.mjs a.mjs

执行后两个模块都会输出true，实现跨模块共享import.meta.env。

方案2：动态共享可修改的环境对象

如果需要支持跨模块修改import.meta.env的属性并全局生效，可以让所有模块的import.meta.env指向globalThis上的同一个对象：

1. 修改加载器文件env-loader.mjs：

import { defaultLoad } from 'node:module';

export async function load(url, context, defaultLoad) {
  const result = await defaultLoad(url, context, defaultLoad);

  if (context.format === 'module') {
    // 让import.meta.env指向globalThis上的共享对象
    const modifiedSource = `
      import.meta.env = globalThis.__IMPORT_META_ENV__;
      ${result.source.toString()}
    `;
    return {
      source: modifiedSource,
      format: 'module'
    };
  }

  return result;
}

2. 在入口模块顶部初始化共享对象：

// a.mjs
// 初始化全局共享环境对象
globalThis.__IMPORT_META_ENV__ = { DEV: true };

import './b.mjs';
console.log('[a.mjs] import.meta.env.DEV', import.meta.env?.DEV);

3. 在其他模块中修改环境属性：

// b.mjs
// 修改属性会全局生效
import.meta.env.DEV = false;
console.log('[b.mjs] import.meta.env.DEV', import.meta.env.DEV);

4. 用加载器运行代码：

node --experimental-loader ./env-loader.mjs a.mjs

执行后会输出：

[b.mjs] import.meta.env.DEV false
[a.mjs] import.meta.env.DEV false

注意事项 #

• Node.js的自定义加载器目前是实验性特性，需要添加--experimental-loader参数才能使用，适合开发环境场景。
• 可以根据实际需求动态生成环境配置，比如读取process.env.NODE_ENV来设置DEV的值：

  const envConfig = JSON.stringify({
    DEV: process.env.NODE_ENV !== 'production'
  });
  

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