> For AI agents: the complete documentation index is available at /zh/llms.txt, the full documentation bundle is available at /zh/llms-full.txt.

# source.alias

:::warning 废弃警告
`source.alias` 已废弃，请使用 [resolve.alias](/zh/configure/app/resolve/alias.md) 代替。
:::

- **类型:**

```ts
type Alias = Record<string, string | false | (string | false)[]> | Function;
```

- **默认值:** `undefined`

设置文件引用的别名，对应 Rspack 的 [resolve.alias](https://rspack.rs/config/resolve#resolvealias) 配置。

:::tip
对于 TypeScript 项目，你只需要在 `tsconfig.json` 中配置 [compilerOptions.paths](https://www.typescriptlang.org/tsconfig#paths) 即可，Rsbuild 会自动识别它，不需要额外配置 `source.alias` 字段，详见 [「路径别名」](https://modernjs.dev/guides/basic-features/alias.html)。
:::

:::info
该配置项的使用方式与 Rsbuild 完全一致。详细信息请参考 [Rsbuild - source.alias](https://v2.rsbuild.dev/zh/config/source/alias)。
:::