发布的npm包在JS环境报错：Cannot find module 'tslib' 求解决

问题根源 #

你的TypeScript配置中开启了importHelpers: true，这个配置会让TypeScript将公共辅助函数（如类型扩展、对象赋值等逻辑）统一从tslib模块导入，而非在每个编译文件中重复生成。但你的package.json未将tslib列为生产依赖，导致纯JavaScript项目安装你的包时，不会自动安装tslib，从而抛出"Cannot find module 'tslib'"错误。

修复步骤 #

1. 将tslib添加为生产依赖 #

在项目根目录执行以下命令，把tslib加入dependencies（而非devDependencies）：

npm install tslib --save

这样所有安装你的carbonimg包的用户，无论使用TS还是JS项目，都会自动获取tslib依赖。

2. 优化编译脚本（可选） #

你的package.json中build脚本存在重复编译的问题：先执行tsc，再执行build:esm（同样是tsc）。可以简化为：

"scripts": {
  "test": "npm run build && jest --watchAll --verbose --coverage",
  "build": "rm -rf dist/ && npm run build:esm && npm run build:cjs",
  "build:esm": "tsc",
  "build:cjs": "tsc --module CommonJS --outDir dist/cjs",
  "prepublish": "npm run build",
  "start": "npm run build && node ."
}

避免重复编译，提升构建效率。

3. 验证修复 #

• 重新执行npm run build生成最新的编译文件
• 在本地创建一个纯JavaScript项目，安装你的carbonimg包进行测试，确认"找不到tslib"的错误已消失。

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