Node.js模块能否导出可直接调用函数？能否全局访问及最佳实践

当然可以在Node.js的一个模块里声明多个函数，并导出成能直接调用的形式，就像你提到的mocha的describe、it或者supertest的工具函数那样～下面一步步给你拆解实现方式和相关的最佳实践：

一、基础实现：解构赋值直接调用 #

你当前的utils.js导出方式是没问题的，想要直接调用函数而不用写utils.xxx，最常用且推荐的方式是解构赋值，在引入模块的时候直接提取需要的函数：

// moduleOne.js
const { foo, bar } = require('./utils');
foo(5); // 输出 10
bar('string'); // 输出 string

这种方式既避免了冗余的前缀，又不会污染全局环境，是Node.js社区的常规写法，可读性和维护性都很强。

二、全局挂载：一处引入，任意位置直接访问 #

如果想要做到“在一处引入模块，之后任意位置都能直接调用函数”，可以把函数挂载到Node.js的global全局对象上：

修改utils.js： #

// utils.js
function foo(val) { console.log(val*2); }
function bar(val) { console.log(typeof val); }

// 将函数挂载到全局对象
global.foo = foo;
global.bar = bar;

// 同时保留导出，方便其他场景按需引入
module.exports = { foo, bar };

在项目入口文件提前引入： #

比如你的项目入口是app.js，只需要在这里引入一次utils.js：

// app.js
require('./utils');
// 其他业务代码...

之后在项目的任意模块里，都不需要再次引入，直接调用foo()和bar()即可。

不过要注意：这种全局挂载的方式尽量少用——全局变量很容易引发命名冲突（比如其他模块也定义了同名的foo函数，会直接覆盖），后期排查问题也会变得困难。

三、关于最佳实践的说明 #

像mocha、supertest这类框架之所以把函数做成全局可调用，是因为它们的使用场景特殊：测试用例的每个文件都需要频繁用到describe、it这些函数，反复引入会增加冗余代码。但在普通的业务开发中，更推荐以下做法：

• 优先使用解构赋值的方式，既保持代码的清晰归属，又避免全局污染；
• 全局挂载只适用于极少数必须全局可用的工具函数，而且要确保函数名称足够独特，降低冲突风险；
• 如果使用ES模块（import/export），写法逻辑和CommonJS一致，只是语法略有不同：

  // utils.mjs
  export function foo(val) { console.log(val*2); }
  export function bar(val) { console.log(typeof val); }
  
  // moduleOne.mjs
  import { foo, bar } from './utils.mjs';
  foo(5);
  bar('string');
  

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