如何在Node.js中实现变量仅在所属npm包内全局生效而非整个项目

方案1：利用模块原生作用域（最推荐） #

Node.js的CommonJS/ESM模块天然具备私有顶级作用域，你只要把原来挂载到global的包内共享变量移到模块顶级声明即可：

• 模块顶级声明的变量仅当前模块可访问，不会泄漏到全局，也不会被其他npm包的同名变量覆盖
• 服务端挂载到global的变量（如needed_variable）依然可以在所有模块内正常读取，不受影响

修改后示例代码 #

packageA.js

// 模块顶级声明，仅当前包内可访问，不会污染global
const db_connection = db.connect(URL_1);
class MS_A {
  test() {
    // 直接使用本地的db_connection
    console.log(db_connection)
    // 可正常读取服务端的全局变量
    console.log(global.needed_variable)
  }
}
module.exports = MS_A;

packageB.js

const db_connection = db.connect(URL_2);
class MS_B {
  test() {
    console.log(db_connection) // 只会拿到B自己的连接
    console.log(global.needed_variable) // 正常读取全局变量
  }
}
module.exports = MS_B;

方案2：包内单例模块共享（适合多文件的复杂npm包） #

如果你的npm包内有多个文件需要共享db_connection这类变量，可以单独封装一个包内的上下文单例模块，利用Node.js模块缓存特性实现包内全局共享：

1. 在packageA内新建internal-context.js

// 包内私有模块，不对外导出
module.exports = {
  db_connection: db.connect(URL_1)
}

2. 包内所有需要用到共享变量的文件，都引入这个私有模块即可：

const ctx = require('./internal-context.js')
console.log(ctx.db_connection)

这个单例仅在当前包内生效，其他包即使有同名的internal-context.js也不会互相干扰。

方案3：闭包封装（适合需要做多实例初始化的场景） #

如果同一个npm包需要在同一台服务上启动多个独立实例（比如同一个微服务包要连两个不同的数据库），可以用闭包封装初始化逻辑：

// 包入口文件
module.exports = function initMS(dbUrl) {
  // 闭包内的变量仅当前实例可访问
  const db_connection = db.connect(dbUrl)
  class MS {
    test() {
      console.log(db_connection)
      console.log(global.needed_variable)
    }
  }
  return MS
}

服务端调用时分别初始化即可：

const MS = require('your-ms-package')
const MSInstance1 = new MS(URL_1).start()
const MSInstance2 = new MS(URL_2).start()
// 两个实例的db_connection完全独立，互不干扰

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