执行pnpm i成功却未生成node_modules文件夹，求排查问题

开发者阿泽

2026-7-17

pnpm install执行成功但无node_modules的排查方向

pnpm默认存储机制导致
pnpm默认采用全局缓存+本地虚拟存储模式，不会生成传统的完整node_modules文件夹，取而代之的是项目根目录下的.pnpm虚拟存储目录，所有依赖通过软链关联到全局缓存。若需要生成传统node_modules，可执行pnpm install --shamefully-hoist；也能用pnpm config get store-dir查看全局缓存位置，确认依赖已被正确缓存。
项目配置了自定义虚拟存储路径
检查项目根目录或全局的.npmrc文件，若存在virtual-store-dir配置，node_modules会被替换为指定的虚拟目录。这是pnpm的优化设计而非错误，查看对应虚拟目录是否存在即可确认依赖已安装。
命令执行目录错误
确保在包含package.json的项目根目录执行pnpm i。若在子目录执行，pnpm会向上查找package.json并在其所在目录生成存储文件，而非当前执行目录。可用pwd（Linux/macOS）或echo %cd%（Windows）确认当前路径与package.json所在路径一致。
生产模式下无依赖需要安装
如果执行的是pnpm install --production，pnpm仅安装dependencies字段下的依赖。若项目package.json中只有devDependencies，执行该命令后不会生成任何依赖目录。检查命令是否带有--production参数，或全局配置中是否设置了production=true。
pnpm缓存或版本问题
执行pnpm store prune清除缓存后重新运行pnpm i；或更新pnpm到最新版本：pnpm add -g pnpm再重试。同时检查.npmrc文件中是否存在ignore-scripts等可能干扰安装流程的配置。