仅导入单个函数为何会触发目标文件中其他代码执行？

问题原因 #

当你在index.ts中导入bmiCalculator.ts时，Node.js会执行该模块内的所有顶层代码——不管代码有没有被导出。你在bmiCalculator.ts的顶层写了以下代码：

const { height, weight } = parseArguments(process.argv);
console.log(calculateBmi(height, weight));

启动Express服务时，process.argv的内容是[node执行路径, index.ts文件路径]，长度仅为3。而parseArguments函数要求参数长度至少为4，因此直接抛出了Not Enough Arguments错误。

解决方法 #

把模块内的命令行执行逻辑包裹在条件判断里，只有当模块被直接运行（而非被其他模块导入）时才执行。针对你的TS代码，修改bmiCalculator.ts的末尾部分：

// 替换原来的顶层执行代码
if (import.meta.main) {
  const { height, weight } = parseArguments(process.argv);
  console.log(calculateBmi(height, weight));
}

这样，当你直接运行bmiCalculator.ts（比如node dist/bmiCalculator.js 180 75）时，这部分代码会正常执行；当index.ts导入该模块时，这部分代码会被跳过，不会触发错误。

补充说明 #

模块的顶层代码在导入时执行是Node.js（以及ES模块规范）的默认行为，目的是初始化模块状态。如果模块里有不需要在导入时执行的逻辑，必须用条件判断限制执行时机。

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