在Windows WSL/Ubuntu环境运行npm install遇Unsupported Platform错误求助

开发者阿泽

2026-8-4

解决WSL/Ubuntu中npm install安装win32包的问题

修复方案

清除npm缓存
缓存可能残留Windows环境下的依赖记录，执行：
```
npm cache clean --force
```
删除lock文件和node_modules
项目中的package-lock.json（或yarn.lock）大概率是在Windows环境生成的，包含了win平台的依赖信息，删除后重新安装：
```
rm -rf node_modules package-lock.json
npm install
```

检查并重置npm平台配置
若npm被强制指定了Windows平台参数，执行以下命令检查并重置：

# 查看当前配置的操作系统
npm config get os
# 如果返回win32，执行重置命令
npm config delete os
npm config delete arch

清理WSL环境变量
避免Windows侧环境变量污染WSL，执行命令检查：
```
printenv | grep -E "(OS|NODE)"
```
如果看到OS=Windows_NT这类Windows变量，在WSL的shell配置文件（~/.bashrc或~/.zshrc）末尾添加：
```
unset OS
```
保存后执行source ~/.bashrc（或对应shell的配置文件）生效。