WSL2环境下npm首次安装依赖卡顿，二次运行正常问题求助

针对你在Windows 10 WSL2 Ubuntu 22.04 LTS环境中遇到的首次npm install卡顿、二次执行成功的问题，结合你的环境（nvm 0.40.1、Node 22.11.0、npm 10.9.0，依赖包含react-email@3.0.2），给出以下实用解决方案：

核心优化方向 #

这类问题通常和WSL2的文件系统性能、npm缓存策略或网络解析效率有关，按优先级尝试以下方案：

1. 迁移项目到WSL本地文件系统 #

WSL2访问Windows挂载目录（/mnt/c、/mnt/d等）依赖9P协议，文件读写性能远低于WSL本地分区。首次npm install会生成大量node_modules文件，放在Windows目录会导致严重卡顿：

• 把项目移动到WSL的本地目录，比如~/my-projects
• 执行pwd确认当前路径不是/mnt开头的挂载目录

2. 调整npm缓存与安装策略 #

• 确认npm缓存目录在WSL本地（默认已配置，可手动指定）：

  npm config set cache ~/.npm
  

• 启用离线优先模式，减少重复网络请求：

  npm config set prefer-offline true
  

• 首次安装时直接使用离线优先参数：

  npm install --prefer-offline --verbose
  

3. 替换npm为更高效的包管理器（推荐） #

pnpm或yarn的缓存机制更高效，对WSL的兼容性更好，能大幅缩短首次安装时间：

• 安装pnpm：

  curl -fsSL https://pnpm.io/install.sh | sh -
  

• 执行pnpm install替代npm install，首次安装速度会有明显提升

4. 优化WSL2 DNS解析（针对网络卡顿场景） #

如果是DNS解析慢导致包下载卡住，可修改WSL网络配置：

1. 创建/编辑WSL配置文件：

   sudo nano /etc/wsl.conf
   

2. 添加以下内容禁用自动生成DNS配置：

   [network]
   generateResolvConf = false
   

3. 编辑DNS配置文件：

   sudo nano /etc/resolv.conf
   

4. 替换为稳定的DNS服务器：

   nameserver 114.114.114.114
   nameserver 8.8.8.8
   

5. 重启WSL生效：在Windows终端执行wsl --shutdown，再重新打开WSL终端

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