问题概述
项目在使用 pnpm 管理依赖时,出现了 “Cannot find module ‘next/link’ or its corresponding type declarations” 的错误。这是因为 pnpm 的软链接机制在某些情况下可能导致模块路径解析问题。
问题诊断
- 通过命令
pnpm list next
确认项目已安装 Next.js 15.2.3 版本 - 检查
node_modules/next
目录,确认目录结构存在 - 检查
.pnpm
存储目录中 Next.js 的软链接情况 - 检查项目配置文件中的依赖声明
解决方案
方法一:清理并重新安装依赖
# 清理 pnpm 存储中不需要的包
pnpm store prune
# 重新安装项目所有依赖
pnpm install
方法二:强制重新安装 Next.js
# 强制重新安装特定版本的 Next.js
pnpm