HTML / CSS / 系统课时

建立标准项目结构

建立标准项目结构

本课以 Vite 与 Tailwind CSS v4 为例,把页面、组件、样式、资源和通用逻辑放入职责明确的目录。完成后,项目可以正常构建,新增功能也能沿固定依赖方向扩展,而不会把所有文件堆在根目录。

学习目标

  • 理解页面、组件、样式、资源和通用逻辑的职责边界
  • 从空项目创建一套可运行的 Tailwind CSS 目录骨架
  • 通过生产构建验证入口、依赖路径和样式扫描是否正确

用职责划分目录

标准结构的重点不是目录名称越多越好,而是让依赖方向可预测:入口加载全局样式并启动页面,页面组合多个组件,组件调用通用逻辑,资源由实际使用者引用。根目录只保留构建、依赖和团队级配置。

标准项目结构与依赖方向

推荐骨架如下。pages 只负责页面级组合,components 保存可复用界面单元,styles 放全局样式入口,assets 放由源码引用的图片与字体,lib 放不依赖具体页面的函数。

text
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;项目名可按实际情况替换。

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

预期结果

text
项目目录:tailwind-structure-demo
已安装依赖:vite、tailwindcss、@tailwindcss/vite
已创建目录:pages、components、styles、assets/images、lib
命令退出码:0

Tailwind CSS v4 的 Vite 接入由 @tailwindcss/vite 插件和主样式中的 @import "tailwindcss"; 组成。:contentReference[oaicite:3]{index=3}

建立入口与组件边界

将 vite.config.js 替换为下面的配置,让 Vite 在构建时处理 Tailwind CSS。

js
import { defineConfig } from "vite";
import tailwindcss from "@tailwindcss/vite";

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

在 src/styles/app.css 中保留唯一的全局 Tailwind 入口。项目级主题、字体和基础规则以后也集中放在这里。

css
@import "tailwindcss";

创建 src/components/button.js。组件只负责可复用按钮,不读取页面状态,也不决定它出现在哪个页面。

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,由页面组合标题、说明和按钮组件。

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。入口只做两件事:加载全局样式,挂载当前页面。

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 样式入口和模板中的类名都能被处理。

bash
npm run build

预期输出

text
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,等项目确实出现对应职责后再扩展。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立标准项目结构

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

登录哪都通