构建选项

build.outDir

• 类型： string
• 默认： dist

指定输出路径（相对于项目根目录)。

build.assetsInlineLimit

• 类型： number
• 默认： 4096 (4 KiB)

小于此阈值的资源url将内联为 base64 编码，以避免额外的 http 请求。设置为 0 可以完全禁用此项。

build.fileHash

• 类型： boolean | '-' | '?'
• 默认： false

build 命令构建后生成的静态资源在它们的文件名中包含了 hash 以便更好的控制缓存，同时也会生成对应的 manifest.json 文件。

• 值为 false 时，关闭文件哈希。
• 值为 true 或 - 时，将生成文件名哈希和版本映射文件manifest.json。
• 值为 ? 时，仅生成版本映射文件manifest.json。

build.sourcemap

• 类型： boolean | 'inline'
• 默认： false

构建后是否生成 source map 文件。如果为 true，将会创建一个独立的 source map 文件。如果为 'inline'，source map 将作为一个 data URI 附加在输出文件中。

build.minify

• 类型： boolean
• 默认： process.env.NODE_ENV === "production"

全局配置, 设置为 false 可以统一禁用最小化混淆或压缩。

⚠️ 提示

该配置项仅对任务类型 type 为 html, style, script, static, image 有效。这里是全局配置，也可以在每个任务项内单独配置 minify。

build.htmlMinify

• 类型： boolean | HtmlMinifyOptions
• 默认： 与 build.minify 一致

HTML 最小化压缩配置项，此选项配置后会覆盖 build.minify。

html压缩是基于 html-minifier-terser 插件, 详细配置请参见 这里。

build.jsMinify

• 类型： boolean | TerserMinifyOptions
• 默认： 与 build.minify 一致

Javascript 最小化混淆配置项，此选项配置后会覆盖 build.minify。

JS最小化混淆是基于 terser 插件, 详细配置请参见 这里。

build.cssMinify

• 类型： boolean | CSSNanoOptions
• 默认： 与 build.minify 一致

CSS 最小化压缩配置项，此选项配置后会覆盖 build.minify。

CSS压缩是基于 cssnano 插件, 详细配置请参见 这里。

build.imageMinify

• 类型： boolean | {plugins?: Plugin[], options?: Options}
• 默认： dist

图片压缩配置项，此选项配置后会覆盖 build.minify。

图片压缩是基于 gulp-imagemin 插件, 详细配置请参见 这里。

🚨 提醒

由于安装 gulp-imagemin 依赖经常失败(国内环境)，且图片压缩是一项耗时的一次性任务。所以 pipflow 将 gulp-imagemin 的安装提取到项目的依赖中。如果你的项目不需要 压缩图片或者手动一次性压缩，请删除项目的 package.json 中的 gulp-imagemin 依赖，并将 imageMinify 配置项的值设置为 false。