npm error could not determine executable to run 是因 Tailwind CSS v4+ 将 CLI 功能从主包剥离，导致 node_modules/.bin/tailwindcss 不生成；需降级至 v3（如 npm install -D tailwindcss@3.4.17）并用 npx tailwindcss@3 init -p 初始化，或改用 Vite 插件方案。
npm error could not determine executable to run 是 v4+ CLI 缺失导致的
这不是环境问题，而是 tailwindcss v4.0+ 已把 CLI 功能从主包剥离，tailwindcss 包本身不再提供可执行文件 —— 所以 npx tailwindcss init 必然失败，node_modules/.bin/tailwindcss 根本不会生成。
如果你需要初始化配置或用 CLI 构建（比如生成调试 CSS），必须锁定 v3：
npm install -D tailwindcss@3.4.17 postcss autoprefixer- 再运行
npx tailwindcss@3 init -p（加@3显式指定版本） - 若项目已用 Vite，优先走插件方案，避免 CLI 依赖
@tailwindcss/vite 加载报错 Failed to resolve “ESM only”
错误信息里出现 Failed to resolve "@tailwindcss/vite"，本质是 Vite 配置文件用了 CommonJS（module.exports）却试图 require 一个纯 ESM 包。
解决方式只有两个可靠路径：
立即学习“前端免费学习笔记（深入）”；
- 把
vite.config.js改为 ESM：用import/export default，并在package.json加"type": "module" - 或直接改扩展名：把配置文件重命名为
vite.config.mjs，不改package.json也能绕过 CommonJS 加载逻辑 - 别在
vite.config.js里写const tailwindcss = require('@tailwindcss/vite')—— 这条语句就是根源
build 后 dist/assets/ 下没有 CSS 或体积极小
这不是 Tailwind 没编译，而是它提取不到任何类名，输出为空（0 字节或 127 B）。根本原因是 content 路径没覆盖实际使用 class 的文件。
常见漏配点：
-
src/**/*.{js,ts}漏了.tsx或.jsx—— React/TSX 文件完全不被扫描 -
public/index.html里写了class="bg-gray-50"，但content里没写./public/index.html -
tailwind.config.js不在项目根目录（比如放在config/下），路径却写./src/**/*—— 应该写../src/**/* - 验证方法：跑
npx tailwindcss -i ./src/input.css -o ./dist/test.css --watch -c ./tailwind.config.js，在 JSX 里加个className="bg-blue-500"，看终端是否输出该类 —— 没输出就说明content路径失效
PostCSS 插件报错 “It looks like you're trying to use tailwindcss directly as a PostCSS plugin”
v4+ 的 tailwindcss 包不再内置 PostCSS 插件，直接在 postcss.config.cjs 里写 tailwindcss: {} 会失败。
正确做法分两步：
- 安装专用插件：
npm install -D @tailwindcss/postcss -
postcss.config.cjs中改为：module.exports = { plugins: { '@tailwindcss/postcss': {}, autoprefixer: {} } } - 注意：Vite 用户如果已用
@tailwindcss/vite插件，通常不需要手动配 PostCSS —— 此时删掉postcss.config.cjs反而更稳妥
