webpack是啥?从入口清单看它和vite的取舍
- 2026年11月22日
- 12 次
把webpack是啥说清楚,落到手上的动作只有一件:入口按清单写,别让它替你猜。我现在所有项目的 entry 都写成对象,键名就是 chunk 名;vite 那边同理,页面超过一个就把 build.rollupOptions.input 列全。多打几行字,换来的是产物路径和入口能一一对上。
这么配的理由不复杂:构建器不认识你的目录结构,只认识你递过去的那份入口清单。目录里多放一个 html,dev server 照常打得开,构建却当它不存在。反过来,只有一个页面、产物叫什么都无所谓的项目,字符串入口就够,套一层对象是自己给自己找活。
从哪个文件开始往下找
webpack 是一个从入口出发、把 import 和 require 串成依赖图、再按图合并输出的打包器。它不扫目录,只认 entry 指到的那几个文件:被 import 链上的才进图,没人引用的文件构建时根本不看。

所以问webpack是啥,答案不在目录结构里,在配置里。src/index.js 只是大家的习惯,不是规则;entry 指到 src/foo.js,它就不看 index.js。
顺带一个细节:entry 写 './src/index' 不带后缀也能跑,webpack 按 resolve.extensions 的顺序补全。补不到时吐的是 Module not found: Error: Can't resolve './src/index',后面跟的那个路径是它查找的目录,不是它没找到的文件,照着目录去核对拼写就行。
两边入口配置的写法差异
webpack 的 entry 三种写法对应三件不同的事。字符串 './src/index.js' 得到的是一个名叫 main 的 chunk,落盘是 dist/main.js,不是 index.js —— 名字跟文件叫什么无关,跟 chunk 名有关。数组写法把几个文件并进同一个 chunk,名字还是 main。只有对象写法能自己命名。
数组写法本身不是错的:把它当成对象里的值,{ app: ['./polyfill.js', './app.js'] } 照样按 app 命名,两个文件按顺序并进同一个 chunk。名字丢掉只发生在顶层直接给数组的时候。
// webpack.config.js
const path = require('node:path');
module.exports = {
entry: {
app: './src/app.js',
admin: './src/admin.js',
},
output: {
path: path.resolve(__dirname, 'dist'),
filename: '[name].js',
clean: true,
},
};
两个键两个 chunk,[name] 取键名,构建完产物是 dist/app.js 和 dist/admin.js 两个文件。先别急着上 [contenthash],名字对不上时哈希只会让排查更难。
配置文档里对 entry 的定位是「构建的起点」,不是「要打包的文件清单」。一个入口长一棵树,两棵树引到同一个同步模块时,默认在两个 chunk 里各留一份,想抽出来得动 splitChunks。

vite 的入口位置换过两次。开发阶段它不读配置文件里的 input,dev server 把项目根下的 index.html 当入口,浏览器请求哪个 html 就顺着里面的 <script type="module"> 往下找。构建阶段才回到 rollup,从 build.rollupOptions.input 取清单,默认只有根目录那一个 index.html。把webpack是啥落到配置上,差别就在这:一边写几个键,一边写几个文件路径。
一个键对应一个 chunk,一条路径对应一个 html,写漏就少一个,两边都不给提示。
构建产物目录怎么对
产出路径两边规则不同。webpack 的目录由 output.path 定死,文件名由 output.filename 模板拼,entry 里写 admin 配 [name].js,出来的是 dist/admin.js,平的。要它落进 dist/admin/index.js,模板得改成 [name]/index.js,键名不会自动变成目录。
vite 反过来:html 按它相对 root 的原路径落盘,admin/index.html 构建完还是 dist/admin/index.html;js 和 css 归到 build.assetsDir 指的目录(默认 assets),文件名走 rollupOptions.output.entryFileNames。input 的键只影响 chunk 名,不改 html 的位置。
还有一层容易漏。import() 拆出来的异步 chunk 走 output.chunkFilename,不是 filename 那个模板,两个得一起改;只改前一个,异步产物会全落在 dist 根下,跟主包混在一起。

回到webpack是啥这条线看,产物目录就是入口的投影:它用键当文件名,vite 用文件位置当目录。同一个 admin,在 webpack 里是 dist/admin.js,在 vite 里是 dist/admin/index.html。
少写一个入口会怎样
vite 多页面构建的失败方式很安静。项目里加了 admin/index.html,dev 下访问 /admin/ 正常,因为 dev 是按请求现找文件;npx vite build 只产出根目录那一个 html,退出码 0,一行提示都没有。第一次遇到会怀疑缓存,删掉 dist 重跑,还是只有一份。
第二个页面的路径要拼成绝对路径再写进 input,相对路径是按启动构建时的工作目录解析的,脚本换个目录跑就指偏了,指偏的表现就是静默少一个页面:
// vite.config.js
import { fileURLToPath } from 'node:url';
import { defineConfig } from 'vite';
export default defineConfig({
build: {
rollupOptions: {
input: {
main: fileURLToPath(new URL('./index.html', import.meta.url)),
admin: fileURLToPath(new URL('./admin/index.html', import.meta.url)),
},
},
},
});
配置文件写成 .mjs,或者 package.json 里写了 "type": "module",__dirname 在这份文件里就不存在了。Vite 自己启动时会用自己的 config 打包器加载配置,顺手把 __dirname 垫上,所以正常 vite build 看不出问题;一旦这份配置被别的工具当原生 ES 模块直接 import(configLoader: 'native',或者被测试框架、打包分析脚本直接加载),就会抛 ReferenceError: __dirname is not defined in ES module scope。稳妥写法是 fileURLToPath(new URL('./admin/index.html', import.meta.url)),它不依赖任何垫片,两种加载方式都对。报错跟版本无关,跟谁在加载这份配置有关。
补完再数一遍:find dist -name '*.html' 应该正好两行,dist/index.html 和 dist/admin/index.html。少一行就回去对路径,别在缓存上找原因。
什么时候别按清单写
单页应用只有一个入口,字符串写法就够,键名只有 main,多套一层对象反而容易改错。用 Next、Nuxt 这类自带路由的框架,入口由框架按文件约定生成,手动往 vite 配置里补 input 多半不生效,得走框架自己的配置项;做组件库要的是 build.lib.entry,那是另一套,和多页面清单不能混。
还有一条边界在流水线上。CI 或部署脚本硬编码了产物路径时(老流水线常见 cp dist/index.js 这种写法),改 entry 结构会连带改产物名,构建成功、上线 404。nginx 的 try_files 指向 dist 里某个具体目录时同理,改目录等于改运维配置,两头得一起动。另,webpack 5 才有 output.clean,4 及以下要装插件清目录,两代的清理方式别混着套。
这套做法只在入口由自己维护时成立。入口被别人生成、产物路径被下游写死、工程还停在 webpack 4,三条占一条,就别急着改清单,先去读生成入口的那份配置。
若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。
- 上一篇: pip安装太慢怎么换源?三类镜像与超时参数
- 下一篇: cursor下载安装教程,装完先改三处默认设置
- jquery选择器里拼接变量怎么写才不出错,我遇到两个坑 2026-11-08
- CSS3中background属性有哪些?background用法解析 2022-09-29
- box-shadow在前端中有什么作用?box-shadow在Css3中怎么使用? 2022-11-01
- PHP如何读取文件?PHP简单读取文件函数及实例 2022-11-07
- 关键词布局区别与联系是什么?按栏目页和详情页分工 2026-11-13
- 火狐浏览器如何查找缓存文件目录?火狐浏览器缓存后的文件在哪儿? 2022-05-31
