HTML / CSS / 系统课时

创建 Tailwind CSS 项目

创建 Tailwind CSS 项目

本课从空目录创建一个最小 Tailwind CSS 项目,完成依赖安装、CSS 入口、HTML 页面和构建验证。最终会生成可直接由浏览器加载的 output.css,并看到工具类已经作用于页面元素。

学习目标

  • 初始化 npm 项目并本地安装 Tailwind CSS CLI。
  • 建立 CSS 输入、编译输出和 HTML 引用关系。
  • 执行一次构建,并验证生成文件与页面样式。

明确最小项目结构

本课采用 Tailwind CSS CLI,不引入框架和额外构建器。项目只需要 package.json、src/input.css、src/index.html,构建后再生成 src/output.css。这种结构足以验证安装链路,也便于后续观察工具类如何转换为实际 CSS。

当前官方 CLI 安装方式是同时安装 tailwindcss 与 @tailwindcss/cli,在 CSS 入口中使用 @import "tailwindcss";,再由 CLI 扫描源文件并输出 CSS。:contentReference[oaicite:2]{index=2}

初始化项目并安装依赖

在准备存放练习项目的目录中运行以下命令。依赖安装在当前项目,不需要全局安装,也不会污染其他项目的版本。

bash
mkdir tailwind-starter
cd tailwind-starter
npm init -y
npm install tailwindcss @tailwindcss/cli
node -e "require('node:fs').mkdirSync('src', { recursive: true })"
npm ls tailwindcss @tailwindcss/cli --depth=0

预期输出:

text
tailwind-starter@1.0.0 <PATH>/tailwind-starter
├── @tailwindcss/cli@<VERSION>
└── tailwindcss@<VERSION>

<PATH> 与 <VERSION> 是动态值,版本号不必完全一致。关键是依赖树中同时出现两个包,并且命令没有报告 missing、invalid 或安装失败。

创建 CSS 入口与页面

新建 src/input.css。这个入口负责加载 Tailwind CSS;在本课的最小项目中,不需要先生成 tailwind.config.js。

css
@import "tailwindcss";

新建 src/index.html,让页面加载稍后生成的 output.css。示例使用布局、间距、颜色、圆角和阴影工具类,能够直观看出编译是否成功。

html
<!doctype html>
<html lang="zh-CN">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Tailwind CSS Starter</title>
    <link rel="stylesheet" href="./output.css" />
  </head>
  <body class="min-h-screen bg-slate-100 p-8">
    <main class="mx-auto max-w-xl rounded-xl bg-white p-8 shadow-lg">
      <p class="text-sm font-semibold text-blue-600">Tailwind CSS</p>
      <h1 class="mt-2 text-3xl font-bold text-slate-900">项目创建成功</h1>
      <p class="mt-4 leading-7 text-slate-600">
        页面已经加载由 Tailwind CSS CLI 生成的样式文件。
      </p>
    </main>
  </body>
</html>

这两个文件属于配置与页面结构,不会单独产生终端输出。它们的生效行为将在下一步通过 CSS 文件大小和浏览器显示结果共同验证。

构建并验证输出

从项目根目录运行构建命令。-i 指定输入文件,-o 指定输出文件;CLI 会扫描 HTML 中出现的工具类,并把对应样式写入 src/output.css。

bash
npx @tailwindcss/cli -i ./src/input.css -o ./src/output.css
node -e "const fs=require('node:fs'); const p='src/output.css'; if(!fs.existsSync(p)||fs.statSync(p).size===0) process.exit(1); console.log('Tailwind CSS 构建成功')"

预期输出:

text
≈ tailwindcss v<VERSION>
Done in <TIME>
Tailwind CSS 构建成功

CLI 的版本、耗时和提示符可能不同,但最后一行应固定出现。随后直接用浏览器打开 src/index.html:页面应为浅灰背景,中间显示白色圆角卡片、蓝色标签、深色大标题和阴影。

开发模式与常见失败

持续编辑页面时,将构建命令加上 --watch。进程会保持运行,并在检测到 HTML 或 CSS 变化后重新生成输出文件;结束时按 Ctrl+C。

bash
npx @tailwindcss/cli -i ./src/input.css -o ./src/output.css --watch

预期结果:

text
CLI 保持运行;修改并保存 src/index.html 后,src/output.css 会被重新生成。

若页面完全没有样式,按顺序检查 output.css 是否存在、HTML 中的 href 是否为 ./output.css、构建命令是否在项目根目录执行。若只有新增加的类不生效,确认包含类名的文件已保存,并观察 watch 进程是否重新构建。

不要通过字符串拼接动态制造不完整类名,例如 text-${color}-600;扫描器需要在源文件中看到完整候选类名。学习阶段先直接写出 text-blue-600 这类完整字符串,能减少“构建成功但样式缺失”的误判。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

创建 Tailwind CSS 项目

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通