可以通过配置?output
?选项,告知 webpack 如何向硬盘写入编译文件。注意,即使可以存在多个?entry
?起点,但只能指定一个?output
?配置。
在 webpack 配置中,output
?属性的最低要求是,将它的值设置为一个对象,然后为将输出文件的文件名配置为一个?output.filename
module.exports = {
output: {
filename: 'bundle.js',
},
};
此配置将一个单独的?bundle.js
?文件输出到?dist
?目录中。
如果配置中创建出多于一个 "chunk"(例如,使用多个入口起点或使用像 CommonsChunkPlugin 这样的插件),则应该使用?占位符(substitutions)?来确保每个文件具有唯一的名称。
module.exports = {
entry: {
app: './src/app.js',
search: './src/search.js',
},
output: {
filename: '[name].js',
path: __dirname + '/dist',
},
};
// 写入到硬盘:./dist/app.js, ./dist/search.js
配置项:
path
: 指定输出文件的存放目录,通常使用 path.resolve(__dirname, 'dist')
来指定当前目录下的 dist
目录作为输出目录。
filename
: 指定输出文件的名称,可以使用 [name]
、[id]
、[hash]
、[chunkhash]
等占位符来生成动态的文件名和路径。
publicPath
: 指定在浏览器中访问输出文件时的公共 URL 前缀,通常用于将静态资源部署到 CDN 上或者在开发模式下使用热更新服务。
chunkFilename
: 指定非入口 chunk 的名称,通常使用 [id]
、[name]
、[hash]
、[chunkhash]
等占位符来生成动态的文件名和路径。
library
: 指定打包后的代码库名称,可以通过全局变量或者 UMD 形式进行引用。
libraryTarget
: 指定打包后的代码库导出方式,可以使用 commonjs
、amd
、umd
、var
等常见的导出方式。
globalObject
: 指定在浏览器环境中执行代码时的全局对象,通常使用 window
、self
、global
等全局对象。
pathinfo
: 指定在生成代码时是否包含文件路径信息,通常用于调试和错误追踪。
以下是对资源使用 CDN 和 hash 的复杂示例:
module.exports = {
//...
output: {
path: '/home/proj/cdn/assets/[fullhash]',
publicPath: 'https://cdn.example.com/assets/[fullhash]/',
},
};
如果在编译时,不知道最终输出文件的?publicPath
?是什么地址,则可以将其留空,并且在运行时通过入口起点文件中的?__webpack_public_path__
?动态设置。
__webpack_public_path__ = myRuntimePublicPath;
// 应用程序入口的其余部分