Node.js模块中两种JS方法写法的差异、适用场景及优劣对比

先贴两种写法的直观示例，方便对照：

类型1：模块级独立函数写法 #

// 未导出的函数，仅模块内部可调用
const privateHelper = () => {
  return '仅内部可见的数据';
};

// 导出供外部调用的公开方法
export const publicMethod = () => {
  const data = privateHelper();
  return `处理后结果：${data}`;
};

类型2：类+私有方法写法 #

class BusinessService {
  // #前缀定义语法级私有方法
  #privateHelper() {
    return '仅类内部可见的数据';
  }

  // 公开方法
  publicMethod() {
    const data = this.#privateHelper();
    return `处理后结果：${data}`;
  }
}

// 导出类实例供外部调用
export default new BusinessService();

核心差异 #

• 封装范围与上下文：
  类型1是模块级封装，私有函数是模块里的独立函数，没有this上下文，传递数据只能靠参数；类型2是类级封装，私有方法属于类实例，能通过this直接访问实例的属性或其他方法，上下文更明确。
• 私有性的可靠性：
  类型1的“私有”是靠模块机制实现的——没导出的函数外部拿不到，但如果模块里的其他导出函数不小心把它返回出去，外部还是能调用；类型2的#私有方法是JS语法层面的硬限制，外部无论怎么操作都访问不到，和Java里的private方法逻辑完全一致。
• 实例复用能力：
  类型1的函数都是单例的，模块加载后就固定了；类型2如果导出的是类本身（不是实例），可以多次new创建不同实例，每个实例有自己独立的状态和私有方法，适合需要多实例的场景。
• 代码风格：
  类型1偏向函数式编程，把逻辑拆成独立的纯函数；类型2是面向对象风格，和你熟悉的Java写法更贴近。

适用场景 #

• 选类型1的情况：
  • 写简单的无状态工具，比如字符串格式化、数据转换这类纯逻辑模块；
  • 追求代码轻量，不想用类的结构，想快速实现功能；
  • 项目是函数式编程风格，或者模块内逻辑独立，不需要共享状态。
• 选类型2的情况：
  • 需要维护实例状态，比如每个实例对应不同用户的服务类；
  • 你更习惯OOP开发模式，想用类来组织复杂的业务逻辑；
  • 要求严格的私有性，不想让内部方法被外部意外访问或修改；
  • 逻辑复杂，需要把相关的属性和方法封装在一起，提升代码可读性和维护性。

哪种更优？ #

没有绝对的最优解，完全看你的场景和开发习惯：

• 如果是Express里的简单中间件、小工具模块，类型1足够用，代码简洁开发快；
• 如果是复杂的业务服务（比如用户管理、订单处理），或者你更熟悉Java的OOP写法，类型2的结构更清晰，私有性也更可靠；
• 刚转JS的话，用类型2的写法会更有亲切感，更容易上手。

内容的提问来源于stack exchange，提问作者Jignesh M. Khatri