You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Angular 15项目使用Swiper 10.3出现导入错误的解决方案咨询

Angular 15 + Swiper 编译错误 TS2691 解决办法

方案1:使用 patch-package 自动维护补丁

这是最推荐的方式,无需手动修改node_modules文件,补丁会保存在项目中,后续安装依赖时自动应用:

  1. 安装依赖:
    npm install patch-package --save-dev
    
  2. 修改node_modules/swiper/types/modules/index.d.ts中的导入语句,将../shared.d.ts替换为../shared
  3. 生成补丁文件:
    npx patch-package swiper
    
  4. 在package.json的scripts字段中添加自动执行脚本:
    "postinstall": "patch-package"
    

后续每次执行npm install,补丁都会自动应用到Swiper的库文件上。

方案2:调整 TypeScript 配置跳过库类型检查

若不想打补丁,可在项目的tsconfig.json中启用skipLibCheck选项,跳过第三方库的类型检查:

{
  "compilerOptions": {
    // 保留原有配置
    "skipLibCheck": true
  }
}

注意:该选项会跳过所有第三方库的类型校验,可能隐藏其他库的类型问题,仅建议作为临时解决方案。

方案3:升级/降级 Swiper 版本

该错误属于Swiper特定版本的类型定义问题,可尝试升级到最新正式版,或降级到已知无此问题的版本(如swiper@9.4.1,可根据实际测试调整):

# 升级到最新版
npm install swiper@latest
# 降级到指定版本
npm install swiper@9.4.1

内容的提问来源于stack exchange,提问作者yoak

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.08 07:40:02