之前被问过很多次“纯 HTML 能不能搭一个视频网站”,说实话很多人第一反应是必须上后端、数据库、播放器 SDK,不然根本跑不起来。但我这次做出来的这个项目,还真就是纯 HTML + CSS + JavaScript 实现的视频网站,没有后端、没有数据库、没有打包工具,甚至连构建都没有,源码拿下来扔到浏览器里就能看。这个项目最核心的价值就是:用最朴素的方式,把视频网站从首页到播放页的完整流程跑通,适合刚接触网页开发的人用来理解“网页到底是怎么组织出来的”,也适合需要快速给客户演示 demo 的场景。
我做的这个纯 HTML 视频网站,最终交付的是一个可以直接打开的静态站点,包含视频列表、分类筛选、播放详情页、播放进度记忆这几个核心能力。视频数据全部用 JS 数组模拟,视频文件放在本地 assets 目录,换内容只需要改一个数据文件就行。整份源码的结构非常清楚,视频文件、封面图、页面、样式脚本全部拆开管理,哪怕你完全不了解前端工程化,也能看懂每一部分在干什么。这篇文章我会从设计思路、信息架构、核心代码、常见坑点四个维度把这个项目完整拆给你看,中间会穿插大量实际踩过的细节,希望对你有用。
1. 为什么我会写一个纯 HTML 的视频网站
1.1 纯静态视频站的真实适用场景
先聊一下我为什么坚持“纯 HTML”而不是直接上成熟方案。视频网站这种产品,本质上是由“内容展示”和“播放能力”两块拼起来的。内容展示部分,比如首页的推荐列表、分类页、详情页的标题简介,这些在纯静态页面里完全可以用 HTML 结构配合少量 JS 遍历实现;播放能力部分,HTML5 的 <video> 标签本身就是浏览器原生能力,视频编码对了、地址能访问,播放器基本就成功了一半。所以做纯静态视频网站,两个核心能力都能被覆盖,不存在“非得后端才能做”的死角。
那什么时候适合用这个方案?我自己的判断是三个场景。第一,学习性质的项目。如果你想搞懂一个网页从零到一是怎么组织起来的,纯 HTML 项目没有框架的魔法、没有脚手架帮你隐藏细节,所有逻辑都是最直白的代码,非常适合入门。第二,原型和演示项目。给甲方或者团队验收 UI 效果、交互流程时,一个能双击就能打开的静态站点,比启动一个前端工程再跑起来要省事得多。第三,内容量可控的小型站点。个人作品集、内部工具、某个专题页,视频数量在几十个以内、没有用户系统、没有评论功能,纯静态完全够用,还能免费托管到各种静态服务器上。
1.2 为什么这个方案能省下服务器成本
我见过很多人一开始就买了一台服务器,装 Nginx、配数据库,只为了放十几个视频。这其实是典型的“杀鸡用牛刀”。纯静态网站的部署成本几乎为零:你可以把整个目录直接扔到对象存储的静态网站托管里,也可以扔到任何支持静态页面的免费托管平台,不需要维护进程、不需要担心接口被刷、不需要配置数据库备份。
这次做的视频网站虽然项目名是“纯 HTML”,但很多细节并不是一个文件搞定那么简单。我采用的是一套合理的前端资源组织方式:首页是 index.html,播放页是 play.html,公共的样式抽到 css/style.css,视频列表的数据放在 js/data.js 里,播放页的交互逻辑单独放一个 js/player.js。这样做的理由很简单——把页面、数据、逻辑分开,后期维护的人不会在一个几万行的 HTML 文件里迷路。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 整体设计与信息架构拆解
2.1 用户路径:从首页列表到播放页
设计视频网站,最先要考虑的就是用户怎么走。我设置的路径非常简单直接:用户打开首页,看到的是视频卡片组成的网格;点击任意一张卡片,进入独立的播放页;播放页里有完整的视频区域、标题、简介和相关推荐。这是一个非常典型的 Web 视频站路径,用户几乎不用学习成本就能上手。
首页信息量是最大的,所以我把首页设计成两部分:顶部的分类筛选条和下方的视频卡片网格。分类筛选条用简单的按钮组实现,点击某个分类会触发 JS 重新过滤数据并渲染对应的视频列表。这个交互逻辑我用的是双状态绑定:一个变量 currentCategory 存当前选中的分类,一个 renderVideos() 方法负责把过滤后的数据渲染到页面上。每次切换分类,改变量、清空容器、重新渲染,三步搞定。这里没引入 Vue、React,因为这种简单需求用原生 JS 反而更直观,还能让看代码的人明白 DOM 操作到底是怎么一回事。
卡片网格我用了 CSS Grid 布局。默认是三列,屏幕小于 900px 变成两列,小于 600px 变成一列。每一张卡片包含封面图、视频时长、标题、播放量四个基础信息。封面图我统一切成 16:9,再用 object-fit: cover 保证裁剪不变形。播放量在数据里写死,当然这只是 mock 数据,但放到卡片上以后视觉效果会丰富很多,也更像一个真实的视频站点。
2.2 目录结构:把视频、页面、数据、样式分开
很多新手写小项目喜欢把所有代码堆在一个 HTML 里,这在小 demo 里没问题,但一旦内容超过一个页面,维护成本会急剧上升。我这次的项目采用了一个非常常规的分层目录,给你看一下核心结构:
text复制.
├── index.html // 首页(视频列表)
├── play.html // 播放页
├── css
│ └── style.css //
