可用vite构建纯css项目:先创建仅含export{}的main.js满足esm入口要求,再在index.html中用link引入css,最后通过配置禁用js解析与注入,实现零js打包。

想用Vite只加载纯CSS文件而不触发JS解析或打包,却遇到Vite强制要求入口文件为JS/TS(如main.js)才能启动开发服务器——这是因为Vite的默认开发服务依赖于JS入口来建立模块图和HMR通道。
创建无JS入口的纯CSS项目
第一步:在项目根目录新建一个空的main.js文件,内容仅保留一行:export {}。
这行代码满足Vite对ESM入口的基本语法要求,不会执行任何逻辑,也不会触发额外的依赖解析。若留空或写//注释,Vite会报错“Module parse failed: Unexpected token”,因为非模块化空文件不被识别为合法ESM。
第二步:在index.html中直接通过<link rel="stylesheet" href="./style.css">引入样式文件,无需任何script标签。
第三步:运行vite命令启动开发服务器,此时浏览器将正常加载CSS,控制台无JS执行痕迹,HMR对CSS文件修改也即时生效。
禁用Vite自动注入JS逻辑
方法一:修改vite.config.js,设置build.rollupOptions.input为['main.js']并关闭build.emptyOutDir以外的所有JS相关插件。
详细的 Three.js 3D 图形参考,涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。
方法二:在vite.config.js中添加plugins: [{ name: 'no-js-hmr', handleHotUpdate() {} }],拦截JS热更新钩子,避免Vite尝试解析JS依赖图。
【关键前提】必须确保index.html中没有<script type="module"></script>或<script src></script>指向任何JS资源,否则Vite仍会尝试编译对应模块。
使用vite-plugin-static-site生成纯CSS静态页
安装插件:npm add -D vite-plugin-static-site。
在vite.config.js中配置:plugins: [staticSite({ entryPoints: ['index.html'] })]。
执行vite build后,输出目录里只有index.html和style.css,完全不生成任何js文件或内联script标签。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










