HTML5项目可通过Webpack、Gulp、直拷贝修正路径或Vite四种方式打包为静态文件：Webpack模块化打包并自动注入资源；Gulp流式处理压缩与哈希；直拷贝法适用于简易单页应用；Vite提供快速构建与ES2015兼容输出。
如果您使用 HTML5 开发前端应用，需要将源码（如 .html、.js、.css、图片等）整合并优化为可直接部署的静态文件，则需借助构建工具完成打包操作。以下是针对 HTML5 项目使用 Webpack 或 Gulp 实现静态文件打包的具体方法：
一、使用 Webpack 打包 HTML5 项目
Webpack 是一个模块打包器，能将 HTML5 项目中的各类资源（JavaScript、CSS、HTML 模板、图片等）作为模块处理，并输出压缩、合并后的静态文件，支持自动注入资源路径、哈希命名防缓存等功能。
1、在项目根目录执行 npm init -y 初始化 package.json。
2、安装 Webpack 及核心依赖：npm install --save-dev webpack webpack-cli html-webpack-plugin clean-webpack-plugin。
立即学习“前端免费学习笔记（深入）”；
3、创建 webpack.config.js 文件，配置入口（如 ./src/index.js）、出口（如 ./dist）、HTML 插件（自动提取并生成 index.html）及资源加载规则（如 css-loader、file-loader）。
4、在 package.json 的 scripts 字段中添加："build": "webpack --mode=production"。
5、运行 npm run build，Webpack 将生成包含压缩后 JS/CSS、自动引入资源链接的 index.html 及静态资源的 dist 目录。
二、使用 Gulp 打包 HTML5 项目
Gulp 是基于流的自动化构建工具，适合对 HTML5 源文件进行复制、压缩、重命名、注入路径等轻量级静态打包任务，无需复杂模块解析，配置直观且执行迅速。
1、全局安装 Gulp CLI：npm install --global gulp-cli。
2、在项目中安装 Gulp 及插件：npm install --save-dev gulp gulp-htmlmin gulp-clean-css gulp-uglify gulp-rev-all gulp-sourcemaps。
3、创建 gulpfile.js，定义任务：读取 src/ 下的 HTML 文件并压缩、CSS 文件压缩、JS 文件压缩混淆、图片无损压缩、所有静态资源复制到 dist/ 并添加哈希版本号。
4、配置默认任务顺序：clean → html → css → js → images → rev。
5、执行 gulp 命令，Gulp 将按流程处理全部源文件，并输出结构完整、体积优化的 dist/ 静态目录。
三、纯 HTML 文件直拷贝 + 资源路径修正打包法
对于无构建依赖的简易 HTML5 单页应用（如仅含 index.html、script.js、style.css、assets/），可跳过 Webpack/Gulp，通过脚本方式统一修正资源引用路径并归档，确保所有相对路径在部署后仍有效。
1、确认所有 HTML 中的 、、 标签均使用相对路径（如 ./css/style.css）。
2、使用 VS Code 或 Sublime Text 批量替换 src/ 目录内所有 href/src 属性值，将 /css/、/js/ 等绝对路径前缀统一改为 ./css/、./js/。
3、新建空文件夹 dist，将 src/ 下全部文件及子目录（含 index.html）完整复制进去。
4、用 zip 工具将 dist 文件夹打包为 app-release.zip，该压缩包即为可直接上传至 Nginx/Apache 的静态部署包。
四、使用 Vite 构建并打包 HTML5 应用
Vite 提供极快的冷启动与热更新能力，其 build 命令默认以 HTML5 兼容模式输出静态资源，生成的文件天然支持跨域、离线访问与传统服务器部署，适用于现代 HTML5 项目快速交付。
1、在项目根目录执行 npm create vite@latest my-html5-app -- --template vanilla 创建基础项目。
2、进入项目目录，运行 npm install 安装依赖。
3、修改 vite.config.js，设置 build.outDir: 'dist' 和 build.target: 'es2015' 以兼容主流浏览器。
4、将原有 HTML5 源码（index.html、main.js、style.css 等）放入 src/ 目录，调整 import 引用关系。
5、执行 npm run build，Vite 将输出包含 index.html、_assets/ 子目录（含哈希命名的 JS/CSS/图片）的 dist 文件夹。
