Tailwind 4 执行 npx tailwindcss init 报找不到可执行程序

项目安装了 Tailwind CSS 4，执行旧教程中的 npx tailwindcss init -p，npm 报 could not determine executable to run。先检查项目实际版本；Tailwind 4 的核心包不再提供旧命令入口，init 子命令也已经移除。

这不是看到 npm 报错就需要清空缓存或提升权限的情况。Tailwind 4.0.2 的核心包没有 bin，CLI 改在 @tailwindcss/cli 包中。即使另行安装 CLI，也不能继续期待 init -p 生成旧版配置。

看项目正在用哪一种集成

在项目目录读取依赖与脚本：

npm ls tailwindcss @tailwindcss/cli @tailwindcss/vite

同时查看 package.json、锁文件和已有构建配置。已经采用 Vite、PostCSS 或框架官方集成时，选择对应路径，不同时添加几套重复处理 CSS 的工具。旧项目如果仍明确依赖 Tailwind 3 的插件和配置，应按项目的迁移要求评估，不能仅为消除这一条错误就升主版本。

下面两种方式都针对采用 Tailwind 4 的项目。安装会修改依赖和锁文件，构建会执行项目工具；先保存现有配置，使用项目指定的 Node、npm 与版本策略。

已有 Vite 项目，接入 Vite 插件

在准备采用该集成的项目中安装相应包：

npm install -D tailwindcss@4 @tailwindcss/vite@4

在现有 Vite 配置中导入插件，并把 tailwindcss() 加入原有 plugins 列表。以下是相关配置结构，须保留原项目插件和其他选项：

import { defineConfig } from 'vite';
import tailwindcss from '@tailwindcss/vite';

export default defineConfig({
  plugins: [tailwindcss()],
});

在应用真正导入的主 CSS 中加入：

@import "tailwindcss";

然后通过项目现有的开发或生产构建脚本运行，不再先执行 init。只创建 CSS 文件而没有从应用入口导入，浏览器仍不会取得这些样式；配置插件也不能代替这一步。

独立 CSS 构建，使用单独的 CLI

不通过 Vite 的项目，如果确实需要 CLI 生成 CSS，可以选这一条集成：

npm install -D tailwindcss@4 @tailwindcss/cli@4
npx @tailwindcss/cli -i ./src/input.css -o ./src/output.css --watch

路径是示例。输入 CSS 同样应导入 Tailwind，输出路径选择项目实际需要的位置，不能覆盖其他手工维护的文件。--watch 会持续运行；生产构建按原脚本的执行方式安排，并把生成的 CSS 交给页面加载。

这条 CLI 命令是执行构建，不是初始化配置。不要在后面追加已移除的 init。npx 可能执行或下载工具，包名和版本应与已审定依赖对应，不把相似包名当作替代。

验收页面实际样式与生产产物

用页面中真实使用的类检查样式是否生成、CSS 是否成功加载，并执行项目的正式构建。开发服务器不再报错，还不足以证明部署时输出路径和页面引用正确。原配置含自定义主题、插件或其他预处理器时，分别验证兼容性。

错误若确实指向全局安装目录权限，检查方向另见npm prefix 与 EACCES。允许依赖构建脚本也不会替一个没有 bin 的核心包生成旧 CLI，不能照搬原生模块缺产物的处理。

撤回时恢复原依赖、锁文件和构建配置，重新生成审定产物；不要通过全局安装另一份 Tailwind 来掩盖项目内版本和集成不一致。