TipTap v2.4.0 StarterKit出现@tiptap/pm依赖解析错误

核心排查与修复步骤 #

1. 强制StarterKit与核心包版本一致 #

TipTap的StarterKit必须和@tiptap/core、@tiptap/pm保持完全相同的版本，版本不匹配是这类子模块解析错误的常见原因。

• 先查看已安装包的版本：

  npm list @tiptap/starter-kit @tiptap/core @tiptap/pm
  

• 若版本不一致，重新安装同版本的StarterKit：

  npm install @tiptap/starter-kit@2.4.0
  

2. 清理依赖缓存后重装 #

缓存损坏可能导致依赖映射异常，执行以下操作：

• 删除本地依赖和锁文件：

  rm -rf node_modules package-lock.json yarn.lock
  

• 重新安装所有依赖：

  npm install
  

3. 检查导入路径是否合规 #

TipTap v2中StarterKit已封装了@tiptap/pm的核心子模块，无需单独导入。确认你的代码导入格式：

import { Editor } from '@tiptap/core'
import StarterKit from '@tiptap/starter-kit'

如果手动导入了@tiptap/pm的子模块，核对路径拼写是否与v2.4.0的模块结构一致。

4. 调整包管理器配置（针对pnpm用户） #

使用pnpm时，严格的peer依赖检查可能触发错误，可临时关闭：

• 在项目根目录的.npmrc文件中添加：

  strict-peer-dependencies=false
  

之后重新安装依赖即可。

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