• Type: ​object​
• Default: ​{}​

配置别名，对 import 或 require 或 usingComponents 中引用的文件做别名映射，用以简化路径或引用替换。

比如：

{
  alias: {
    foo: '/tmp/to/foo',
  }
}

然后代码里 import 'foo' 实际上会 import '/tmp/to/foo'。

再比如：

{
  alias: {
    Utilities: path.resolve(__dirname, 'src/utilities/'),
    Templates: path.resolve(__dirname, 'src/templates/'),
  }
}

那么，原先在代码里面基于相对路径引用的文件

import Utility from '../../utilities/utility'

就可以简化为

import Utility from 'Utilities/utility'

一些使用上的小窍门：

1、alias 的值最好使用绝对路径，尤其是指向依赖时，记得加 require.resolve，比如：

// 不推荐 ⛔
{
  alias: {
    foo: 'foo',
  }
}

// 推荐 ✅
{
  alias: {
    foo: require.resolve('foo'),
  }
}

2、如果不需要子路径也被映射，记得加 $ 后缀，比如：

// import 'foo/bar' 会被映射到 import '/tmp/to/foo/bar'
{
  alias: {
    foo: '/tmp/to/foo',
  }
}

// import 'foo/bar' 还是 import 'foo/bar'，不会被修改
{
  alias: {
    foo$: '/tmp/to/foo',
  }
}