typescript版本与@types/lodash版本不兼容问题解决思路

一、发现问题

最近由于自行开发的组件库升级到tdesign-vue-next最新的版本,遇到了打包依赖版本不兼容问题。打包时控制台报错如下:

二、定位问题

1、肯定是lodash和typescript校验问题,那么实际是@types/lodash这个依赖和typescript问题

2、由于官方的UI库调整组件依赖 lodash 为 lodash-es从而导致组件库打包tsc命令无法通过。

三、分析问题

首先、应该检查两个包@types/lodash和typescript版本的兼容性。typescript得版本可能会影响类型的定义。@types/lodash的版本可能依赖于某个特定的typescript,我们的项目typescript是~4.5.5也就是4.5.x的版本。通常@types的包更新会跟随特定typescript版本。typescript又是会有破坏性的变更,比如4.5版本引入了某些新特性,或者修改了类型推断方式,这都可能导致旧的@types包不兼容。

四、解决问题

1、确定typescript与@types/lodash确实存在兼容性问题

2、查看node_modules中@types/lodash的版本

发现要求的typescript的版本是5.0+

而我们组件库依赖的typescript版本是~4.5.5

2、升级typescript得版本显然影响范围更大,成本更高,那就去降@types/lodash版本,问题是降到什么版本合适呢?

3、查看npm包我们会发现typescript版本是4.5+的版本号

4、于是乎去安装,按理说这个类型只用于打包时使用,安装到devDependencies即可

然后想象很美好,现实很骨感,发现如此打包还是报错

5、猜想有可能是安装第三方依赖包时,会自带这个依赖包从而导致版本被覆盖

这时候我们就要回忆一下npm的依赖解析机制了。当安装一个包时,如果该包的dependencies

或者devDependencies中声明了某个依赖,npm默认会尝试安装最新的兼容版本,但具体的行为取决于版本范围

如果本地已经有一个版本,新的安装包要求的版本与本地兼容则不会改变,否则不兼容,可能会安装另一个版本,导致node_modules中出现多个版本

6、查看tdesign-vue-next的package.json是否显示的依赖了特定的版本,是否与你本地的冲突

通过命令 npm view tdesign-vue-next dependencies验证td的依赖

很明显他确实固定了版本要求,而该版本要求typescript是5.0+与我们项目4.5.x冲突

7、固定本地的版本到dependecies中,如果是项目环境只需要放到devDependecies中,但是组件库又提供给第三方应用使用

所以应该固定到dependencies中,而事实证明,放到dependencies中组件库打包才不会报错,放到devDependencies则仍然报错

相关推荐
m0_敲代码的彭于晏1683 小时前
Vercel 前端部署平台深度评测
前端
怕浪猫5 小时前
外包和大厂的前端代码,差在凌晨三点
前端·面试·github
m0_敲代码的彭于晏1685 小时前
Vercel 前端部署与全栈开发实战指南
前端·状态模式
徐小夕5 小时前
花了3个月,我们做了一款 AI 版的“飞书文档”
前端·算法·github
贾伟康5 小时前
【化学实验室|17】HarmonyOS ArkTS 亮暗色与视觉令牌实战:集中颜色、间距和交互状态避免页面割裂
前端·移动开发·harmonyos·arkts·arkui
Csvn6 小时前
SSR/SSG/ISR(上):峡谷与渲染策略的时间预算
前端
Csvn6 小时前
SSR/SSG/ISR(下):可交互性、新鲜度与回源账
前端
Elcker9 小时前
YnuoAgent(依诺):一个 npm 包,跑起属于自己的 AI 研发平台
前端·人工智能·npm
计算机魔术师9 小时前
发现2天,修复2个月:AI挖穿PHP后,卡兹克讲透攻防时间差
前端
风骏时光牛马9 小时前
测试标题001
前端