直接运行 vite 即可启动 html 开发服务器，无需配置、框架或 js 模块，只要根目录有 index.html；常见错误包括未安装 vite 依赖、index.html 位置或命名错误、误用 vite preview 替代开发服务器，路径引用须以 index.html 所在目录为基准。
直接运行 vite 就能启动 HTML 开发服务器
不用写配置、不用装框架、不依赖 JS 模块，只要根目录有 index.html，执行 vite 命令就会自动启动带热更新的开发服务器。Vite 把 HTML 当作入口，不是“附带支持”，而是原生一等公民。
常见错误现象：Cannot find module 'vite' 是没装依赖；No index.html found 是文件不在当前执行目录下，或名字拼错（必须是 index.html，大小写敏感）。
- 确保已执行
npm install -D vite（或pnpm add -D vite） -
index.html必须在你运行vite的那个目录里，不能放在src/下再用vite src/index.html—— 这种写法不被支持 - 端口默认是
5173，被占时会自动 +1，但不会告诉你新端口是多少，建议启动后手动访问http://localhost:5173确认
vite build 和 vite preview 完全不是一回事
很多人误把 vite preview 当成开发服务器用，结果改了 HTML 刷新没反应、JS 不加载、HMR 失效——因为它根本不处理源码，只跑构建产物。
-
vite：启动开发服务器，支持 HMR、ESM 原生加载、模块解析、CSS 热替换 -
vite build：把index.html及其引用的 JS/CSS 资源打包输出到dist/（纯 HTML 项目实际就是复制文件） -
vite preview：仅起一个静态 HTTP 服务来跑dist/，不解析import，不支持 HMR，仅用于验证构建结果是否可部署
也就是说：没先跑过 vite build，vite preview 就会报错 “Cannot find dist”。
html-to-pptx-converter
下载
使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。
HTML 中路径引用必须以 index.html 所在位置为基准
Vite 开发服务器的资源服务逻辑和传统 Web 服务器一致，所有相对路径都从 index.html 文件所在目录算起，不是从项目根、也不是从 src/ 目录。
-
<script src="./main.js"></script>✅ 正确：同级 JS -
<script src="main.js"></script>✅ 浏览器自动补./，但显式写更稳妥 -
<script src="/src/main.js"></script>❌ 错误：除非你手动配server.fs.allow: ['./src']，否则 Vite 默认拒绝访问/src/下的文件 - CSS 里的
url()同样遵循此规则，比如background: url(./img/logo.png)才能正常加载
需要代理、HTTPS 或自定义端口？加 vite.config.js
纯 HTML 项目可以完全不写配置，但一旦遇到跨域调试、端口冲突、本地 HTTPS 测试等真实场景，就得加配置文件了。Vite 会自动识别并加载它。
- 端口改 3000：
server: { port: 3000 } - 启用 HTTPS：
server: { https: true }（会自动生成证书） - 代理 API 请求：
server: { proxy: { '/api': 'http://localhost:8080' } } - 放宽文件访问限制（如需读
src/下的模板）：server: { fs: { strict: false, allow: ['./src'] } }
注意：fs.allow 是安全边界，生产环境切勿设为 ['.'] 或开放过多路径，本地开发也建议最小化授权。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
