Node.js跨文件require时lineCount重复打印及add报错的解决

两类异常的核心诱因是两个模块形成了双向循环require，且在模块顶层编写了无执行边界的副作用代码。 #

异常1：运行第一个模块时，count结果重复打印两次 #

根因 #

第一个模块的顶层代码直接调用了lineCount()，这类无判断的顶层执行逻辑属于模块加载副作用：只要Node加载该模块，顶层代码就会触发一次，对应一次文件读取流程、一次count结果打印。
两个模块互相require形成循环依赖后：

• 直接运行第一个模块时，第一行代码触发加载第二个模块
• 第二个模块的第一行又反过来触发加载第一个模块，此时第一个模块还处于加载中断状态
  注释掉第二个模块的require语句后，循环依赖断裂，第一个模块的顶层代码仅在直接命令行运行时执行一次，count自然只打印一次；保留require语句时，循环加载流会让第一个模块的顶层副作用代码被触发两次，最终出现重复打印。

修复方案 #

给顶层的副作用代码加上运行环境判断，避免模块被其他文件require时重复执行。

Node.js有内置规则：只有直接通过命令行执行的模块，require.main === module的值为true；如果模块是被其他文件require加载的，该值为false。
修改第一个模块的顶层调用逻辑：

// 仅在直接运行当前文件时，执行统计与add调用
if (require.main === module) {
  lineCount()
  fun1.add()
}

调整后，两个模块互相被require时，只会执行函数定义、导出的初始化逻辑，不会触发顶层的调用副作用，count仅在直接运行文件时打印一次。 #

异常2：运行第一个模块时报TypeError: add is not a function #

根因 #

循环模块加载时，Node不会等待模块完全加载完成，会把已经开始加载、但尚未执行完的模块的半成品导出对象，直接返回给对应的require调用方。
当前代码的加载流中，循环依赖会导致引用错位：

1. 直接运行第一个模块时，第一行require(第二个模块)触发第二个模块加载
2. 第二个模块的第一行require(第一个模块)触发反向加载，此时第一个模块仅执行到第一行，Node直接把第一个模块的空半成品导出对象返回给第二个模块
3. 模块加载顺序错位时，第一个模块拿到的fun1引用尚未完成add属性的挂载，导致调用fun1.add()时找不到方法，抛出类型错误。
   双向循环require是Node.js模块设计中明确需要规避的反模式，本身就会导致加载时序不可控、导出对象不完整的问题。

修复方案 #

• 打破循环依赖：把两个模块共享的逻辑抽成独立的第三个公共模块，两个模块都直接依赖这个公共模块，不再互相直接require，从根源上避免循环加载的问题。
• 调整调用时序：把模块顶层的依赖调用移到函数内部执行，等所有模块完成加载、导出完整后，再触发依赖方法的调用，不要在模块初始化阶段就跨模块直接调用方法。
• 固定导出时机：如果必须保留互相require的结构，要把所有函数定义、模块导出逻辑写在文件最开头，所有require语句放在导出逻辑之后，避免因为加载顺序错位拿到半成品导出。

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