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}
初始化项目并安装依赖
在准备存放练习项目的目录中运行以下命令。依赖安装在当前项目,不需要全局安装,也不会污染其他项目的版本。
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预期输出:
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。
@import "tailwindcss";新建 src/index.html,让页面加载稍后生成的 output.css。示例使用布局、间距、颜色、圆角和阴影工具类,能够直观看出编译是否成功。
<!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。
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 构建成功')"预期输出:
≈ tailwindcss v<VERSION>
Done in <TIME>
Tailwind CSS 构建成功CLI 的版本、耗时和提示符可能不同,但最后一行应固定出现。随后直接用浏览器打开 src/index.html:页面应为浅灰背景,中间显示白色圆角卡片、蓝色标签、深色大标题和阴影。
开发模式与常见失败
持续编辑页面时,将构建命令加上 --watch。进程会保持运行,并在检测到 HTML 或 CSS 变化后重新生成输出文件;结束时按 Ctrl+C。
npx @tailwindcss/cli -i ./src/input.css -o ./src/output.css --watch预期结果:
CLI 保持运行;修改并保存 src/index.html 后,src/output.css 会被重新生成。若页面完全没有样式,按顺序检查 output.css 是否存在、HTML 中的 href 是否为 ./output.css、构建命令是否在项目根目录执行。若只有新增加的类不生效,确认包含类名的文件已保存,并观察 watch 进程是否重新构建。
不要通过字符串拼接动态制造不完整类名,例如 text-${color}-600;扫描器需要在源文件中看到完整候选类名。学习阶段先直接写出 text-blue-600 这类完整字符串,能减少“构建成功但样式缺失”的误判。