执行npm install后node_modules子目录为空引发tailwind命令报错

清理安装残留 #

• 删除本地node_modules文件夹：rm -rf node_modules（Mac/Linux）或rmdir /s /q node_modules（Windows）
• 删除package-lock.json锁文件：rm package-lock.json（Mac/Linux）或del package-lock.json（Windows）
• 强制清理npm缓存：npm cache clean --force

匹配Node版本配置 #

你的.nvmrc指定了lts/jod，但当前使用的是Node v22.14.0，先切换到对应LTS版本：

• 执行nvm use自动读取.nvmrc切换版本
• 用node -v确认版本，应为v20.x系列（LTS Jod的版本范围）

重新安装依赖 #

运行npm install，安装时留意控制台是否有网络、权限类报错。如果仍有问题，尝试：

• npm install --force：强制安装，解决版本冲突导致的部分依赖未安装问题
• npm install --legacy-peer-deps：兼容旧版依赖的peer依赖配置

修正Tailwind命令脚本 #

Tailwind CSS v4.x的CLI调用方式已简化，无需通过@tailwindcss/cli路径调用，修改package.json的scripts：

"scripts": {
  "tailwind": "tailwindcss -i ./assets/css/tailwind.css -o ./assets/css/style.min.css --watch"
}

验证修复效果 #

• 检查node_modules/@tailwindcss目录，确认内部有完整的依赖文件
• 执行npm run tailwind，验证CSS编译是否正常运行

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