fes.js/docs/zh/guide/config.md
2022-01-06 12:57:22 +08:00

2.0 KiB

配置

Fes.js 约定 .fes.js 文件为项目编译需要配置文件,可以引入 node 端依赖项,不要引入浏览器端依赖项。

一份常见的配置示例如下:

export default {
    base: '/foo/',
    publicPath: '/',
    devServer: {
        port: 8080
    }
    mock: {
        prefix: '/v2'
    },
    proxy: {
        '/v2': {
            'target': 'https://api.douban.com/',
            'changeOrigin': true, 
        },
    },
    layout: {
        title: "Fes.js",
        footer: 'Created by MumbelFe',
        multiTabs: false,
        menus: [{
            name: 'index'
        }, {
            name: 'onepiece'
        }, {
            name: 'store'
        }, {
            name: 'simpleList'
        }]
    }
}

本地临时配置文件

可以新建 .fes.local.js 作为本地临时配置文件。这份配置会和 .fes.jsdeep merge 后形成最终配置。

// .fes.js
export default { mock: false };

// .fes.local.js
export default { 
    mock: true,
    dvServer: { port: 8080 }
};

最终的配置是:

{ 
    mock: true,
    devServer: { port: 8080 }
};

::: warning .fes.local.js 是本地验证使用的临时配置,仅在 fes dev 时有效,请将其添加到 .gitignore,务必不要提交到 git 仓库中。 :::

多环境多份配置

可以通过环境变量 FES_ENV 区分不同环境,来指定当前环境的配置文件,这份配置会和 .fes.jsdeep merge 后形成最终配。

比如配置如下:

// .fes.js
export default { mock: false };

// .fes.uat.js
export default { 
    mock: true,
    dvServer: { port: 8080 }
};

当我们运行:

FES_ENV=uat fes dev

这时候会命中 .fes.uat.js 这份环境配置,最终配置是:

{ 
    mock: true,
    devServer: { port: 8080 }
};

优先级

本地临时配置 > 环境配置 > 基础配置

::: tip 如果多份配置中存在相同的配置项,则优先级高的会覆盖优先级低的。 :::