HTML / CSS / 系统课时
建立标准项目结构
建立标准项目结构
本课以 Vite 与 Tailwind CSS v4 为例,把页面、组件、样式、资源和通用逻辑放入职责明确的目录。完成后,项目可以正常构建,新增功能也能沿固定依赖方向扩展,而不会把所有文件堆在根目录。
学习目标
- 理解页面、组件、样式、资源和通用逻辑的职责边界
- 从空项目创建一套可运行的 Tailwind CSS 目录骨架
- 通过生产构建验证入口、依赖路径和样式扫描是否正确
用职责划分目录
标准结构的重点不是目录名称越多越好,而是让依赖方向可预测:入口加载全局样式并启动页面,页面组合多个组件,组件调用通用逻辑,资源由实际使用者引用。根目录只保留构建、依赖和团队级配置。

推荐骨架如下。pages 只负责页面级组合,components 保存可复用界面单元,styles 放全局样式入口,assets 放由源码引用的图片与字体,lib 放不依赖具体页面的函数。
tailwind-structure-demo/
├── index.html
├── package.json
├── vite.config.js
├── public/
└── src/
├── main.js
├── pages/
│ └── home.js
├── components/
│ └── button.js
├── styles/
│ └── app.css
├── assets/
│ └── images/
└── lib/创建最小项目骨架
从空目录创建 Vite 项目,安装 Tailwind CSS 的 Vite 插件,再建立职责目录。以下命令适用于 Bash;项目名可按实际情况替换。
npm create vite@latest tailwind-structure-demo -- --template vanilla
cd tailwind-structure-demo
npm install
npm install tailwindcss @tailwindcss/vite
mkdir -p src/pages src/components src/styles src/assets/images src/lib
rm -f src/counter.js src/style.css src/javascript.svg预期结果
项目目录:tailwind-structure-demo
已安装依赖:vite、tailwindcss、@tailwindcss/vite
已创建目录:pages、components、styles、assets/images、lib
命令退出码:0Tailwind CSS v4 的 Vite 接入由 @tailwindcss/vite 插件和主样式中的 @import "tailwindcss"; 组成。:contentReference[oaicite:3]{index=3}
建立入口与组件边界
将 vite.config.js 替换为下面的配置,让 Vite 在构建时处理 Tailwind CSS。
import { defineConfig } from "vite";
import tailwindcss from "@tailwindcss/vite";
export default defineConfig({
plugins: [tailwindcss()],
});在 src/styles/app.css 中保留唯一的全局 Tailwind 入口。项目级主题、字体和基础规则以后也集中放在这里。
@import "tailwindcss";创建 src/components/button.js。组件只负责可复用按钮,不读取页面状态,也不决定它出现在哪个页面。
export function renderButton(label) {
return `
<button class="rounded-lg bg-slate-900 px-4 py-2 text-sm font-medium text-white hover:bg-slate-700">
${label}
</button>
`;
}创建 src/pages/home.js,由页面组合标题、说明和按钮组件。
import { renderButton } from "../components/button.js";
export function renderHome() {
return `
<main class="mx-auto max-w-3xl px-6 py-16">
<h1 class="text-3xl font-bold text-slate-900">Tailwind CSS 项目骨架</h1>
<p class="mt-4 text-slate-600">页面负责组合,组件负责复用。</p>
<div class="mt-8">${renderButton("开始学习")}</div>
</main>
`;
}最后替换 src/main.js。入口只做两件事:加载全局样式,挂载当前页面。
import "./styles/app.css";
import { renderHome } from "./pages/home.js";
const app = document.querySelector("#app");
if (!app) {
throw new Error("Missing #app mount element");
}
app.innerHTML = renderHome();构建并检查边界
执行生产构建,验证模块路径、Tailwind 样式入口和模板中的类名都能被处理。
npm run build预期输出
vite v<VERSION> building for production...
✓ <COUNT> modules transformed.
dist/index.html
dist/assets/index-<HASH>.css
dist/assets/index-<HASH>.js
✓ built in <TIME><VERSION>、<COUNT>、<HASH> 和 <TIME> 会随环境变化。若出现模块找不到,先从报错文件检查相对路径;若页面有内容但没有样式,确认 main.js 已导入 styles/app.css;若只有少量动态类缺失,不要拼接不完整类名,而应让完整类名以静态字符串出现在源码中。
新增文件时遵守一个简单判断:能被多个页面复用的界面放 components,只服务单个路由的组合放 pages,无界面依赖的函数放 lib。不要为了“整齐”提前创建空的 services、store 或 hooks,等项目确实出现对应职责后再扩展。