本文介绍不依赖 node.js、npm 或 composer 的轻量级方案，通过 tailwind 官方独立 cli 工具，在传统 php 项目中构建并使用 tailwind css，适用于无框架的静态结构化 php 站点。
本文介绍不依赖 node.js、npm 或 composer 的轻量级方案，通过 tailwind 官方独立 cli 工具，在传统 php 项目中构建并使用 tailwind css，适用于无框架的静态结构化 php 站点。
在没有现代前端构建工具或 PHP 框架的纯 PHP 项目中（如仅含 index.php、header.php、db.php 等文件的扁平结构），直接使用 Tailwind CSS 并非必须引入完整开发环境。Tailwind Labs 提供了 Standalone CLI（独立可执行二进制工具），它无需 Node.js 运行时、不依赖 npm/yarn，开箱即用，完美契合轻量级 PHP 部署场景。
✅ 快速集成步骤（以 Linux/macOS 为例，Windows 同理）
-
下载 Standalone CLI
访问 Tailwind CSS Releases 页面，下载对应操作系统的最新版二进制文件（如 tailwindcss-linux-x64 或 tailwindcss-macos-x64）。
→ 将其复制到项目根目录（即包含 src/ 的目录），重命名为 tailwindcss，并赋予可执行权限：chmod +x tailwindcss
-
初始化配置
在项目根目录下运行：./tailwindcss init
自动生成 tailwind.config.js。按需编辑该文件，关键项为 content —— 明确声明所有含 Tailwind 类名的 PHP 模板路径：
// tailwind.config.js module.exports = { content: [ "./src/**/*.php", // 覆盖 src/ 下所有 .php 文件（含 header.php, index.php 等） "./src/**/*.html" ], theme: { extend: {}, }, plugins: [], } -
编写入口 CSS 并构建
在 src/css/ 下创建 input.css：@tailwind base; @tailwind components; @tailwind utilities;
执行构建命令（启用 --watch 实时监听）：
./tailwindcss -i ./src/css/input.css -o ./src/css/output.css --watch
✅ 此命令会自动创建 output.css（若不存在），并持续监听 input.css 和所有 content 中声明的 PHP 文件变更，按需提取并生成精简后的 CSS。
立即学习“PHP免费学习笔记（深入）”；
-
在 PHP 模板中引入样式
中添加：
在 header.php 或 index.php 的<link rel="stylesheet" href="./src/css/output.css">
即可在任意 PHP 文件中直接使用 Tailwind 类名，例如：
<!-- src/index.php --> <?php include 'header.php'; ?> <main class="container mx-auto p-4"> <h1 class="text-2xl font-bold text-indigo-700">用户列表</h1> <ul class="mt-4 space-y-2"> <?php foreach ($users as $user): ?> <li class="bg-white rounded-lg shadow p-3 flex items-center"> <span class="font-mono text-sm bg-gray-100 px-2 py-1 rounded"><?= htmlspecialchars($user['id']) ?></span> <span class="ml-3"><?= htmlspecialchars($user['name']) ?></span> </li> <?php endforeach; ?> </ul> </main> <?php include 'footer.php'; ?>
⚠️ 注意事项与最佳实践
- 路径匹配要精准：content 数组中的 glob 模式（如 "./src/**/*.php"）必须能实际匹配到你的 PHP 模板文件，否则类名将被 PurgeCSS 移除，导致样式丢失。
- PHP 输出需转义：务必对动态插入 DOM 的内容使用 htmlspecialchars()，避免 XSS，同时不影响 Tailwind 类名解析（类名在服务端是静态字符串，不受影响）。
-
生产环境优化：构建命令默认启用 PurgeCSS，已自动剔除未使用的类；如需进一步压缩，可追加 --minify 参数：
./tailwindcss -i ./src/css/input.css -o ./src/css/output.css --minify
-
Windows 用户提示：下载 tailwindcss-windows-x64.exe，运行时去掉 ./ 前缀，改用：
tailwindcss-windows-x64.exe -i ./src/css/input.css -o ./src/css/output.css --watch
Tailwind 的 Standalone CLI 让「纯 PHP + 原生 CSS」开发范式焕发新生——无需构建锁、不增加部署复杂度，只需一个二进制文件，即可享受响应式工具类、暗色模式、自定义主题等现代 CSS 能力。对于中小型企业官网、内部管理后台或教学演示项目，这是兼顾效率与简洁性的理想选择。
