如何在Node.js上下文注入全局变量？无需导入即可跨文件访问

当然可以做到！Node.js和浏览器环境类似，也提供了全局对象体系来让你挂载自定义变量，这样所有JS文件都能直接访问目标变量，无需手动import或require。下面分两种常用场景给你具体实现方案：

1. CommonJS模块环境（Node.js默认模式） #

在CommonJS里，你可以直接把变量挂载到global对象上——这就相当于浏览器里的window对象，是Node.js默认的全局载体。

实现步骤： #

• 在项目入口文件（比如index.js）里，先定义好你的全局对象并挂载到global：

// 模拟一个document对象及方法
global.document = {
  findById(id) {
    console.log(`正在查找ID为${id}的元素`);
    // 这里可以补充你的实际业务逻辑
    return { id, content: "模拟返回的元素内容" };
  }
};

• 之后在项目的任意其他CommonJS文件里，直接使用document即可：

// 无需手动require，直接调用方法
const targetElement = document.findById('111');
console.log(targetElement);

2. ES模块环境（使用import/export） #

如果你的项目开启了ES模块（在package.json里设置了"type": "module"），global对象不会默认暴露，这时推荐用标准的globalThis对象来挂载全局变量——它是ES标准定义的全局对象，同时兼容CommonJS和ES模块环境。

实现步骤： #

• 在入口文件里完成全局挂载：

// 入口文件（比如index.js）
globalThis.document = {
  findById(id) {
    console.log(`ES模块下查找ID为${id}的元素`);
    return { id, content: "ES模块环境的模拟元素" };
  }
};

• 其他ES模块文件直接访问使用：

// 无需import，直接调用方法
document.findById('111');

注意事项 #

• 全局变量污染风险：虽然这种方式很便捷，但全局变量容易引发命名冲突，还会增加代码的耦合度，建议只在必要场景使用（比如模拟浏览器核心环境对象）。
• 启动顺序要求：务必确保挂载全局变量的代码在其他业务代码执行前运行，最好放在入口文件的最开头，或者作为项目启动的前置脚本。

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