TypeScript4.8库import时触发npm bin脚本执行问题求助

这不是TypeScript 4.x的行为变化导致的，完全是你的代码写法和模块依赖关系出了问题，和package.json的bin配置无关。

核心问题原因 #

你提供的那个bin脚本代码（对应configure-this-and-that.js的源文件）存在致命问题：模块顶层代码直接执行了业务逻辑，没有任何条件判断。在Node.js/TypeScript模块系统中，只要某个模块被直接或间接导入，它的顶层代码就会自动执行——不管你有没有用到这个模块导出的内容。

至于TS 3.7时没出现这个问题，大概率是以下两种情况之一：

• 旧版本TS的打包/模块解析逻辑，使得主入口的Anything模块和这个bin脚本模块之间没有形成依赖链，所以导入主模块时不会触发它；
• 旧版本的打包工具（比如tsc配合tree-shaking）把这段未被引用的顶层执行代码给剔除了，而TS 4.x的打包逻辑没有做这个优化。

解决方法 #

1. 给bin脚本添加执行条件判断 #

修改你的bin脚本，让它只有在被直接作为命令行工具运行时才执行逻辑，被模块导入时仅导出必要内容（如果需要的话），不执行业务代码。

针对ES模块，用import.meta.url和process.argv[1]判断：

#!/usr/bin/env node
import { DeployUtility } from './deploy-utility';

// 仅当脚本被直接命令行调用时，才执行业务逻辑
if (import.meta.url === `file://${process.argv[1]}`) {
  const deployUtility = new DeployUtility();
  deployUtility.configureDomainMapping().then(data => {
    console.log(data);
  });
}

// 如果需要让其他模块导入该工具类，就导出；不需要的话可以删掉
export { DeployUtility };

如果是CommonJS模块，用require.main === module判断：

#!/usr/bin/env node
const { DeployUtility } = require('./deploy-utility');

if (require.main === module) {
  const deployUtility = new DeployUtility();
  deployUtility.configureDomainMapping().then(data => {
    console.log(data);
  });
}

module.exports = { DeployUtility };

2. 检查并切断不必要的依赖链 #

排查你的库主入口模块（Anything所在文件）的依赖关系，看看是不是不小心通过某个子模块间接引入了这个bin脚本模块。如果是，调整模块结构，把bin脚本和库的核心业务代码完全分离，避免交叉依赖。

关于package.json的bin配置 #

bin字段的作用只是将这些脚本注册为全局或局部的命令行可执行命令，本身不会导致导入包时触发脚本执行，你的bin配置是没问题的。

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