Next.js Lightning CSS错误：找不到模块'lightningcss.win32-x64-msvc.node'

问题描述 #

在Windows环境下使用Next.js 15.2.4、Tailwind CSS 4.0.17和pnpm启动开发服务器时，出现以下错误：

Error evaluating Node.js code
Error: Cannot find module '../lightningcss.win32-x64-msvc.node'
Require stack:
- F:\NextJS\basic-nextjs-app\node_modules\.pnpm\lightningcss@1.29.2\node_modules\lightningcss\node\index.js
- F:\NextJS\basic-nextjs-app\node_modules\.pnpm\tailwindcss@4.0.17\node_modules\tailwindcss\postcss\dist\index.js
- F:\NextJS\basic-nextjs-app\.next\build\chunks\turbopack\_runtime.js
- F:\NextJS\basic-nextjs-app\.next\transform.js

已尝试清理依赖重装、手动安装lightningcss、更新依赖、禁用TurboPack，均未解决问题。

解决方案 #

1. 强制安装适配Windows平台的lightningcss #

执行命令强制重新安装指定版本的lightningcss，明确指定Windows平台和x64架构，覆盖可能缓存的不兼容二进制包：

pnpm install lightningcss@1.29.2 --force --platform=win32 --arch=x64

若使用npm：

npm install lightningcss@1.29.2 --force --platform=win32 --arch=x64

2. 清理pnpm全局缓存后重装依赖 #

pnpm的全局缓存可能存在损坏的二进制文件，清理后重新安装所有依赖：

pnpm store prune
rm -rf node_modules .next pnpm-lock.yaml
pnpm install

3. 降级lightningcss到兼容版本 #

Tailwind CSS 4.0.17依赖的lightningcss@1.29.2可能存在Windows适配问题，尝试降级到已知兼容的1.28.1版本，并强制Tailwind CSS使用该版本：

pnpm add lightningcss@1.28.1 --override

4. 通过环境变量强制平台适配 #

启动开发服务器前设置环境变量，指定Node.js使用win32平台模块：
CMD命令行：

set NODE_PLATFORM=win32
pnpm run dev

PowerShell：

$env:NODE_PLATFORM="win32"
pnpm run dev

5. 检查包管理器配置文件 #

查看项目根目录的.pnpmrc或.npmrc文件，确保没有设置错误的平台参数，例如若存在platform=linux需删除或修改为platform=win32。

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