如何解决NativeWind中'Cannot find module lightningcss.win32-x64-msvc.node'错误

报错内容 #

Error: Cannot find module '../lightningcss.win32-x64-msvc.node'

环境信息 #

• 操作系统：Windows 11 64位
• Node.js版本：v22.11.0
• npm版本：10.9.0
• React Native版本：0.76.6
• NativeWind版本：^4.1.23

已尝试无效操作 #

rm -rf node_modules package-lock.json
npm rebuild lightningcss
npm cache clean --force
npm install

有效解决方案 #

1. 降级Node.js到LTS版本 #

Node.js v22属于较新的非LTS版本，和lightningcss的二进制包兼容性可能存在问题。建议切换到v20.x LTS版本：

• 用Node版本管理工具（如nvm）安装并切换到v20.x
• 重新执行依赖清理与安装：

rm -rf node_modules package-lock.json
npm install

2. 锁定兼容的lightningcss版本 #

NativeWind v4.1.23默认依赖的lightningcss版本可能在Windows环境下缺失对应二进制包，手动在package.json中指定兼容版本：

"dependencies": {
  // 其他依赖...
  "lightningcss": "^1.25.1"
}

然后执行：

rm -rf node_modules package-lock.json
npm install

3. 切换npm源并重新安装 #

部分npm源的二进制包资源不全，切换到国内镜像源尝试：

npm config set registry https://registry.npmmirror.com/
npm config set disturl https://npmmirror.com/dist
rm -rf node_modules package-lock.json
npm install

4. 手动补全二进制文件 #

如果以上方法都不行，手动下载对应二进制包：

1. 先执行一次npm install生成node_modules目录
2. 进入node_modules/lightningcss，创建build/Release目录（如果不存在）
3. 找到lightningcss官方发布的win32-x64-msvc版本.node文件，放入上述目录
4. 重启项目验证问题是否解决

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