执行npx tailwind init初始化Tailwind CSS时报错如何解决

按以下步骤逐一排查即可解决问题：

• 先校验Node.js版本
  Tailwind CSS v3 要求本地Node.js版本≥12.13.0，v4版本要求Node.js版本≥18.0.0。终端执行node -v查看当前版本，版本不满足要求直接升级到Node.js LTS长期支持版，版本过低是初始化命令报错的最常见诱因。
• 确认项目基础配置完整
  执行tailwind相关命令前，必须先在项目根目录执行npm init -y生成package.json文件，缺失该文件时npx没有执行上下文，会直接抛出运行错误。
• 核对所用Tailwind版本对应的命令
  如果你安装的是Tailwind CSS v4及以上版本，旧版的npx tailwind init命令已经废弃：
  1. 先执行安装命令：npm install tailwindcss @tailwindcss/cli
  2. 再执行初始化命令：npx @tailwindcss/cli init
• 修复输入CSS文件的报错
  输入文件报错基本都是指令写错导致的，和版本对应即可：
  • v3版本在输入CSS文件顶部写入以下三行指令：

  @tailwind base;
  @tailwind components;
  @tailwind utilities;
  

  • v4版本在输入CSS文件顶部写入以下导入语句即可：

  @import "tailwindcss";
  

• 清理异常缓存重试
  以上步骤都确认无误仍报错的话，直接删除项目根目录下的node_modules文件夹、package-lock.json文件，重新执行npm install安装全量依赖后，再跑初始化命令即可。

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