工程配置
icejs 支持的工程配置项列表，所有配置项都在 build.json 文件 中编写。
entry#
- 类型：
string|object|array - 默认值：src/app.[t|j]s
icejs 中一般不允许修改该配置。
alias#
- 类型：
object - 默认值： ``
在 icejs 默认配置了 { "@": "./src/" } 的规则，因此项目大多数时候不需要配置，配置完成后则可以更加简单的导入模块了：
publicPath#
- 类型：
string - 默认值：
/
配置 webpack 的 output.publicPath 属性。 仅在运行 build 命令时生效。
devPublicPath#
- 类型：
string - 默认值：
/
同 publicPath 仅在执行 start 时生效
sourceMap#
- 类型：
boolean - 默认值：
false
externals#
- 类型：
object - 默认值：
{}
将某些 import 的包排除在 bundle 之外，在运行时再去外部获取这些依赖。 比如，从 CDN 引入 React 资源，而不是将它打包
详细配置同 webpack 的 externals
例如通过配置 externals 减少图表资源大小：
在使用到图表（Bizcharts）的时候，会发现打包后的文件特别大。是由于图表库本身比较大，这样会影响页面的加载效率。可以通过 CDN 的方式加载图表库，在打包时排除掉对应的图标库。
说明：key 表示依赖包名，如： bizcharts。 value 表示引用 CDN 后的全局变量名，如: BizCharts
将 CDN 文件添加到 public/index.html 中：
hash#
- 类型：
boolean|string - 默认值：
false
如果希望构建后的资源带 hash 版本，可以将 hash 设置为 true
可以设置为 contenthash 的方式：
polyfill#
- 类型：
string - 默认值：
"entry" - 可选值：
"usage"|"entry"|false
配置 @babel/preset-env 处理 polyfill 的逻辑，不同值的含义：
entry: 根据配置的browserslist字段在每个文件开头都引入对应的polyfill。false: 不引入任何polyfill。usage: 根据源码中使用到的代码按需引入polyfill。
注意： 在 usage 模式下，默认不会去分析 node_modules 里的代码，如果需要的话，请看 compileDependencies 字段相关的说明，添加相关需要编译的依赖。
injectBabel#
已废弃，请使用 polyfill 替代。
- 类型：
string - 默认值：
polyfill - 可选值：
"polyfill"|"runtime"|false
默认情况下会注入 core-js/stable 和 regenerator-runtime/runtime，根据 targets 配置的兼容浏览器进行 polyfill，实现按需添加。 开发类库项目，可以将配置设置为 runtime。 如果想手动 polyfill，可以将配置设置为 false，工程将不会进行自动的 polyfill。
minify#
- 类型：
boolean - 默认值：
true
构建后的资源将进行压缩，如果不希望资源被压缩可以修改为 false
outputAssetsPath#
- 类型：
object - 默认值：
{ js: 'js', css: 'css' }
修改构建后的 css/js 文件目录，默认情况下 css 在 build/css/ 下，js 在 build/js/ 下，可以通过 outputAssetsPath 配置修改：
outputDir#
- 类型：
string - 默认值：
build
修改构建后的文件目录
proxy#
- 类型：
object - 默认值：
{}
配置 webpack 的 devServer.proxy 属性。
建议使用
proxy来设置代理而不要修改 webpack 的devServer.proxy
代理的每一项配置都可以通过 enable 字段来快速开关代理配置
devServer#
- 类型：
object - 默认值：
{}
注意，devServer 不支持 port 属性配置，如需改变端口，请通过命令行参数传入。
define#
- 类型：
object - 默认值：
{}
配置全局变量。
browserslist#
- 类型：
string|object - 默认值：
last 2 versions, Firefox ESR, > 1%, ie >= 9, iOS >= 8, Android >= 4
配置 @babel/preset-env 的浏览器最低版本(https://babeljs.io/docs/en/babel-preset-env#targets)，新配置的 browserslist 会覆盖默认值。
注: 因 targets 字段被使用，这里使用 browserslist 字段替代 @babel/preset-env 的 targets 字段。
vendor#
- 类型：
boolean - 默认值：
true
MPA 场景下配置是否生成 vendor，如果希望禁用：
libraryTarget#
- 类型：
string - 默认值：
''
配置 webpack 的 output.libraryTarget 属性。
library#
- 类型：
string - 默认值：
''
配置 webpack 的 output.library 属性。
libraryExport#
- 类型：
string - 默认值：
''
配置 webpack 的 output.libraryExport 属性。
compileDependencies#
- 类型：
array - 默认值：
[]
默认情况下 babel-loader 会编译相关模块以兼容 IE11。如果需要 babel 去编译 node_modules 下的指定文件，可以在这个配置快捷添加。
比如想编译 node_modules 下的 @alifd/next 依赖，可以进行如下设置：
注意：配置为 "compileDependencies": [""] 等同于不忽略 node_modules。
cssLoaderOptions#
- 类型：
object - 默认值：
{}
为 css-loader 提供快捷配置，将与默认配置进行浅合并。详细配置可参考 css-loader options。
lessLoaderOptions#
- 类型：
object - 默认值：
{}
为 less-loader 提供快捷配置，将与默认配置进行浅合并。详细配置可参考 less-loader options。
ice.js 目前默认内置 less 4.x 版本，计算函数对于使用 '/' 的方式默认不进行计算，即类似使用 round(1 / 2) 的方式将报错，修复方案如下：
也可以通过包裹括号的方式，让编译器对 / 操作符进行计算，比如 round((1 / 2))。
sassLoaderOptions#
- 类型：
object - 默认值：
{}
为 sass-loader 提供快捷配置，将与默认配置进行浅合并。详细配置可参考 sass-loader options。
ice.js 内置使用 sass 进行编译，如果期望使用 node-sass，请在项目中进行依赖
postcssOptions#
- 类型：
object - 默认值：无
配置方式：
配置规则：
- 工程已内置
postcss-preset-env，配置后将自动合并其参数 - 如果工程未内置 postcss 插件，对应配置将会添加到所以样式处理规则的
postcss-loader配置上 - 设置为
false的 postcss 插件，将从配置中移除
postcssrc#
- 类型：
boolean - 默认值：
false
适用于需要完全重写 postcss 配置。开启配置项后，工程上将清空内置 postcss 配置，读取 postcss 配置文件 postcssrc.js 或 postcss.config.js 中的配置。
terserOptions#
- 类型：
object - 默认值：
{}
以生产环境移除 console 为例，可以进行如下配置：
为 terserPlugin 提供快捷配置，将与默认配置进行浅合并。详细配置可参考 terser options
注意该配置方式在 ice.js 1.17.2 版本以上开始支持
babelPlugins#
- 类型：
array - 默认值：
[]
为 babel-loader 的配置追加额外的 babel plugin。
babelPresets#
- 类型：
array - 默认值：
[]
为 babel-loader 的配置追加额外的 babel preset。如果配置 preset 与内置相同，则优先使用 babelPresets 中的配置内容。
ignoreHtmlTemplate#
- 类型：
boolean - 默认值：
false
开启后，在 build 构建时，将移除所有内置 html-webpack-plugin 设置，不再生成 html 文件。
eslint#
- 类型：
boolean|object - 默认值：
undefined
说明：
undefined：即没有设置 eslint 选项，将 eslint 错误输出到终端里false：不检测 eslint 错误true：将 eslint 错误展示在预览页面上object：表现等同于true，同时支持配置 eslint-loader 的更多参数
disableRuntime#
- 类型：
boolean - 默认值：
false
禁用运行时的能力，如需关闭配置为 true 即可。
tsChecker#
- 类型：
boolean - 默认值：
false
默认关闭 TypeScript 类型检测，如需开启配置为 true 即可。
dll#
- 类型：
boolean - 默认值：
false
是否启用 DllPlugin 构建 DLL。
配置为 true 时，默认为 package.json dependencies 构建 DLL。可通过 dllEntry 字段配置指定依赖。
启用该选项后，进行 Webpack 构建时，会在目录中生成 dll 文件夹，包含 dll 相关代码。
dll 构建产物无需 git 提交，建议加到 .gitignore 中。
dllEntry#
- 类型：
object - 默认值：
{}
开启 dll 后，可通过该选项配置指定依赖。
配置格式为：
以 react、react-dom 为例:
产物如下：
webpackPlugins#
- 类型：
object - 默认值：无
通过 webpackPlugins 可以方便地新增或者修改工程上的 webpack 插件配置。
配置方式：
配置规则如下：
- 对于 webpack 内置的 plugins，可以通过 webpack.PluginName 的形式作为 key 值进行配置
- 对于其他 webpack 插件，需要将插件的 npm 包名作为 key 值进行配置，package.json 中需要添加并安装该插件依赖
- 每一项插件配置支持 before/after 用来调整 webpack 插件执行顺序
- 如果配置设置的插件已被添加，则修改插件配置
webpackLoaders#
- 类型：
object - 默认值：无
通过 webpackLoaders 可以方便地新增或者修改工程上的 webpack loader 配置。
配置方式：
配置规则如下：
- webpackLoaders 配置下每一项为具体的 webpack loader 规则，支持参数
- test：配置类型
string|string[]，同 Rule.test - oneOf：配置类型
[oneOfName: string]: { resourceQuery: string; loaders: Loaders }，同Rule.oneOf - includeClear：清除默认 include 配置
- include：配置类型
string|string[]，同 Rule.include - excludeClear：清除默认 exclude 配置
- exclude：配置类型
string|string[]，同 Rule.exclude - pre：配置类型
boolean，配置 rule 的 enforce 值为 pre - post：配置类型
boolean，配置 rule 的 enforce 值为 post - before：配置类型
string，用于配置定义顺序，前置指定 - after：配置类型
string，用于配置定义顺序，后置指定 - loaders：配置具体的 webpack loader
- test：配置类型
- loaders 参数用来指定具体 webpack loader 的参数；每一项 loader 参数支持 before/after 用来调整 webpack loader 的执行顺序；如果 loader 名已被添加，则修改插件配置
modularImportRuntime#
- 类型：
boolean - 默认值：
true
ice.js 1.14.0 版本以上开始支持
开启后将按需加载运行时能力，以减小构建包体积
esbuild#
- 类型：
object - 默认值：无
使用 esbuild 对构建产物进行压缩，可选配置参考 esbuild 配置文档