Question

如何配置

比如要

# OS X, Linux
$ PORT=3000 umi dev

# Windows (cmd.exe)
$ set PORT=3000&&umi dev

# Or use cross-env for all platforms
$ yarn add cross-env --dev
$ cross-env PORT=3000 umi dev

# .env
$ echo PORT=3000 > .env

环境变量

UMI_ENV

指定覆盖默认配置的配置文件。比如 UMI_ENV=prod umi build，那么则会用 .umirc.prod.js 覆盖 .umirc.js。或者是 config/config.prod.js 覆盖 config/config.js。注意是覆盖而不是替换，.umirc.prod.js 中没有的配置者会使用 .umirc.js 中的配置。

另外，开发模式下 .umirc.local.js 或者 config/config.local.js 中的配置永远是优先级最高的。

PORT

指定端口号，默认是 8000。比如：

$ PORT=8001 umi dev

BASE_PORT

指定基础端口号，umi 会基于这个值去寻找可用的端口号，默认是 8000。比如：

$ BASE_PORT=8001 umi dev

HOST

默认是 0.0.0.0。

ESLINT 2.4.0+

有值时在 dev 和 build 命令里会通过 eslint-config-umi 做基础的 eslint 校验，避免一些低级错误。

APP_ROOT

注意

APP_ROOT 不能配在 .env 里。

指定项目根目录。比如：

$ APP_ROOT=src/renderer umi dev

ANALYZE

默认关闭。分析 bundle 构成，build 时有效。比如：

$ ANALYZE=1 umi build

ANALYZE_SSR

默认关闭。分析 umi.server.js 构成，ssr build 时有效。比如：

$ ANALYZE_SSR=1 umi build

ANALYZE_MODE

默认为 server. 若开启 ANALYZE，且选择了 server 模式，会启动一个 HTTP server 展示 webpack bundle 报告。如果是 disabled，只会生成 stats 文件

# 只生成 stats 文件
$ ANALYZE=1 ANALYZE_MODE=disabled umi build

# 启动 HTTP 服务展示 webpack bundle 报告
$ ANALYZE=1 ANALYZE_MODE=server umi build

ANALYZE_REPORT

默认关闭。分析 bundle 构成并生成报告文件 (默认 bundlestats.json )，供手工分析或可视化用。比如：

$ ANALYZE_REPORT=1 umi build

与开启 ANALYZE 并指定 ANALYZE_DUMP 后生成的 stat 文件不同，ANALYZE 会直接将 [ Webpack Stat 数据转存成目标文件，而 ANALYZE_REPORT 会先对 Webpack Stat 进行解析与裁剪，把可以直接用于分析与可视化的报告数据生成报告文件。

这样做的好处是，我们可以得到更小（仅有 stat 文件 1% 大小）的数据文件。

SPEED_MEASURE

默认关闭。分析各个 plugin 和 loader 的耗时。比如：

# 将分析信息在控制台输出
$ SPEED_MEASURE=CONSOLE umi build

# 将分析信息保存到 node_modules/speed-measure.json
$ SPEED_MEASURE=JSON umi build

ANALYZE_PORT

ANALYZE 服务器端口，默认 8888。

BABEL_POLYFILL 2.2.0+

默认引入 @babel/polyfill，值为 none 时不引入。比如：

$ BABEL_POLYFILL=none umi build

COMPRESS

默认压缩 CSS 和 JS，值为 none 时不压缩，build 时有效。比如：

$ COMPRESS=none umi build

CSS_COMPRESS

默认压缩，值为 none 时不压缩，build 时有效。因为 css 压缩有时是会有问题的，而且压缩并不能减少多少尺寸，所以有时可以压 JS 而不压 CSS。

BROWSER

默认自动开浏览器，值为 none 时不自动打开，dev 时有效。比如：

$ BROWSER=none umi dev

CLEAR_CONSOLE

默认清屏，值为 none 时不清屏。

CLEAR_OUTPUT

默认情况下，输出目录会在每次构建之前被清除，当此值为 none 时则不会执行此操作。

HMR

默认开启 HMR，值为 none 时禁用，值为 reload 时文件有变化时刷新浏览器。

ERROR_OVERLAY

默认开启 ERROR_OVERLAY，值为 none 时禁用，禁用后则react-error-overlay不会弹出错误遮罩层。

BABELRC

开启 .babelrc 解析，默认不解析。

BABEL_CACHE

默认开启 babel cache，值为 none 时禁用。比如：

$ BABEL_CACHE=none umi dev

MOCK

默认开启 mock，值为 none 时禁用。比如：

$ MOCK=none umi dev

HTML

默认打包 HTML 文件，值为 none 时不打包 HTML 文件。比如：

$ HTML=none umi build

WATCH_FILES

RM_TMPDIR

FORK_TS_CHECKER

默认不开启 TypeScript 检查，值为 1 时启用。比如：

$ FORK_TS_CHECKER=1 umi dev

USE_PUBLIC_IP

默认不绑定公网IP，值为 true 时允许绑定公网IP。比如：

$ USE_PUBLIC_IP=true umi dev