解决Tiptap项目中pnpm安装@tiptap/pm时的peerDependency丢失问题

在使用Tiptap编辑器时，开发者可能会遇到一个常见的依赖管理问题：当通过pnpm安装@tiptap/pm包时，peerDependencies（对等依赖）可能会丢失。这个问题通常表现为安装后项目无法正常运行，因为缺少必要的依赖关系。

问题现象

当执行pnpm add @tiptap/pm命令时，虽然包本身会被安装，但它的peerDependencies（即该包正常工作所依赖的其他包）不会被自动安装。这会导致项目运行时出现各种错误，因为核心依赖关系不完整。

问题原因

这个问题的根源在于pnpm的严格依赖管理机制。与npm和yarn不同，pnpm默认不会自动安装peerDependencies，这是pnpm设计上的一个特性，旨在保持依赖树的精确性和可预测性。这种设计虽然有助于避免依赖冲突，但在某些情况下会给开发者带来不便。

解决方案

针对这个问题，有几种可行的解决方法：

1. 使用--shamefully-hoist参数： 执行以下命令可以强制pnpm提升依赖：

   pnpm install --shamefully-hoist
   

   这个参数会让pnpm像npm/yarn那样提升依赖，从而解决peerDependencies问题。

2. 手动安装缺失的peerDependencies： 检查@tiptap/pm包的package.json文件，查看它需要哪些peerDependencies，然后手动安装这些依赖。

3. 修改pnpm配置： 在项目根目录的.npmrc文件中添加：

   auto-install-peers=true
   

   这样pnpm就会自动安装peerDependencies。

最佳实践建议

对于Tiptap项目，建议开发者：

1. 始终检查安装后的依赖树是否完整
2. 在项目文档中明确列出所有peerDependencies
3. 考虑使用pnpm的workspace功能来管理复杂的依赖关系
4. 定期更新依赖版本以避免潜在的兼容性问题

理解pnpm的这种行为差异对于前端项目的依赖管理非常重要，特别是在使用像Tiptap这样有复杂依赖关系的编辑器库时。选择适合自己团队的解决方案，可以显著提高开发效率和项目稳定性。