由 dawei 在Linux系统中搭建H5开发环境，推荐使用轻量高效的组合：Node.js + Vue CLI（或Vite）+ Nginx + SQLite（开发阶段）+ MySQL（生产备选）。所有工具均通过包管理器安装，避免手动编译带来的兼容性问题。
安装Node.js可使用NodeSource仓库：依次执行curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -，再运行sudo apt install -y nodejs。验证安装：node -v与npm -v应返回版本号。随后全局安装Vite：sudo npm install -g create-vite。
创建H5项目：运行npm create vite@latest my-h5-app — –template vue，进入目录后执行npm install，再npm run dev启动本地开发服务器（默认http://localhost:5173）。浏览器即可实时预览并热更新代码。
数据库存储推荐分层配置：前端调试阶段用SQLite，零配置、单文件、无服务进程。安装sqlite3驱动：npm install sqlite3 –save，配合Knex.js或Drizzle ORM封装数据库操作。在项目src目录下新建db/目录，放置data.db文件，初始化脚本可通过package.json的scripts字段一键执行。
若需MySQL支持（如联调后端API或模拟真实部署），使用apt安装：sudo apt install mysql-server mysql-client libmysqlclient-dev。首次运行sudo mysql_secure_installation加固安全。创建开发专用数据库与用户：登录后执行CREATE DATABASE h5_dev CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;和CREATE USER ‘h5dev’@’localhost’ IDENTIFIED BY ‘devpass123’; GRANT ALL ON h5_dev. TO ‘h5dev’@’localhost’;
AI渲染效果图，仅供参考
前端与数据库交互不直连，而是通过本地API代理实现。在vite.config.js中配置server.proxy，将/api/请求转发至本地Node.js Mock服务（如json-server）或后端接口，确保跨域无忧且逻辑解耦。Nginx仅在构建后部署时启用：build输出dist目录，将其设为Nginx根路径，启用gzip与静态缓存提升H5加载性能。