克隆项目后pnpm运行后端报错：已安装tslib仍提示需安装

1. pnpm 缓存或依赖链接异常 #

pnpm 的硬链接机制可能导致 tslib 未被正确引用，哪怕 package.json 已配置。缓存旧数据或链接失效都会让 Node 找不到 tslib：

• 试试清理 pnpm 缓存后重装依赖：pnpm store prune && pnpm install
• 检查项目 node_modules 下是否有 tslib 文件夹，若缺失或文件损坏，手动删除 node_modules 和 pnpm-lock.yaml 后重新安装

2. TypeScript 配置与 tslib 版本不兼容 #

如果 tsconfig.json 开启了 compilerOptions.importHelpers: true，但 tslib 版本和当前 TypeScript 版本不匹配，就会触发这个错误：

• 先查项目使用的 TS 版本：pnpm tsc -v，TS 5.x 建议搭配 tslib ^2.6.0 及以上，你用的 2.3.0 版本偏旧
• 升级 tslib 到兼容版本：pnpm add tslib@latest -D

3. Monorepo/工作区依赖层级冲突 #

如果是 monorepo 项目，根目录和子项目的 tslib 可能存在版本冲突，或者工作区配置导致子项目无法正确获取依赖：

• 检查根目录和后端子项目的 package.json，确认 tslib 是安装在子项目本地还是根目录，若为根目录安装，确保子项目能正常访问
• 查看 pnpm-workspace.yaml，确认没有排除 tslib 的规则

4. Node 模块解析路径被干扰 #

自定义的 NODE_PATH 环境变量或 tsconfig 的路径配置可能影响模块解析，导致找不到 tslib：

• 检查终端环境变量：Linux/macOS 执行 echo $NODE_PATH，Windows 执行 echo %NODE_PATH%，如果有非默认路径，临时取消后重新运行项目
• 查看 tsconfig.json 的 baseUrl 和 paths 配置，确认没有错误映射 tslib 的路径

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