Rolldown 中文网

Appearance

解决选项 ​

¥Resolve Options

  • 类型：object

    ¥Type: object

  • 默认值：查看各个选项

    ¥Default: See individual options

模块解析配置。

¥Configuration for module resolution.

alias ​

  • 类型：Record<string, string[] | string | false>

    ¥Type: Record<string, string[] | string | false>

  • 可选：是 ✅

    ¥Optional: Yes ✅

  • 路径：resolve.alias

    ¥Path: resolve.alias

模块别名映射。

¥Map of module aliases.

示例 ​

¥Examples

js
export default {
  resolve: {
    alias: {
      '@': '/src',
      'utils': './src/utils',
    },
  },
};

深入探讨 ​

¥In-depth

警告

resolve.alias 不会调用其他插件的 resolveId 钩子。如果你想调用其他插件的 resolveId 钩子，请改用 rolldown/experimental 中的 aliasPlugin。有关更多讨论，请参阅 此问题。

¥resolve.alias will not call resolveId hooks of other plugins. If you want to call resolveId hooks of other plugins, use aliasPlugin from rolldown/experimental instead. See this issue for more discussion.

aliasFields ​

  • 类型：string[][]

    ¥Type: string[][]

  • 可选：是 ✅

    ¥Optional: Yes ✅

  • 路径：resolve.aliasFields

    ¥Path: resolve.aliasFields

package.json 中用于检查别名路径的字段。

¥Fields in package.json to check for aliased paths.

conditionNames ​

  • 类型：string[]

    ¥Type: string[]

  • 默认值：平台相关

    ¥Default: Platform-dependent

  • 路径：resolve.conditionNames

    ¥Path: resolve.conditionNames

在 package.json 中解析导出时使用的条件名称。基于平台和导入类型的默认值：

¥Condition names to use when resolving exports in package.json. Defaults based on platform and import kind:

  • 浏览器平台：["import", "browser", "default"] 表示 import 语句，["require", "browser", "default"] 表示 require() 调用

    ¥Browser platform: ["import", "browser", "default"] for import statements, ["require", "browser", "default"] for require() calls

  • Node 平台：["import", "node", "default"] 表示 import 语句，["require", "node", "default"] 表示 require() 调用

    ¥Node platform: ["import", "node", "default"] for import statements, ["require", "node", "default"] for require() calls

  • 中立平台：["import", "default"] 表示 import 语句，["require", "default"] 表示 require() 调用

    ¥Neutral platform: ["import", "default"] for import statements, ["require", "default"] for require() calls

extensionAlias ​

  • 类型：Record<string, string[]>

    ¥Type: Record<string, string[]>

  • 可选：是 ✅

    ¥Optional: Yes ✅

  • 路径：resolve.extensionAlias

    ¥Path: resolve.extensionAlias

扩展与替代扩展的映射。用于在使用 .js 扩展名导入时解析 TypeScript 文件。使用此配置，import './foo.js' 将首先尝试解析为 foo.ts，然后再回退到 foo.js。

¥Map of extensions to alternative extensions. Useful for resolving TypeScript files when importing with .js extension. With this configuration, import './foo.js' will try to resolve to foo.ts first, then fall back to foo.js.

示例 ​

¥Examples

js
export default {
  resolve: {
    extensionAlias: {
      '.js': ['.ts', '.js'],
    },
  },
};

exportsFields ​

  • 类型：string[][]

    ¥Type: string[][]

  • 可选：是 ✅

    ¥Optional: Yes ✅

  • 路径：resolve.exportsFields

    ¥Path: resolve.exportsFields

package.json 中用于检查导出的字段。

¥Fields in package.json to check for exports.

extensions ​

  • 类型：string[]

    ¥Type: string[]

  • 默认值：['.tsx', '.ts', '.jsx', '.js', '.json']

    ¥Default: ['.tsx', '.ts', '.jsx', '.js', '.json']

  • 路径：resolve.extensions

    ¥Path: resolve.extensions

解析文件时要尝试的扩展。这些将按从头到尾的顺序进行尝试。

¥Extensions to try when resolving files. These are tried in order from first to last.

mainFields ​

  • 类型：string[]

    ¥Type: string[]

  • 默认值：平台相关

    ¥Default: Platform-dependent

  • 路径：resolve.mainFields

    ¥Path: resolve.mainFields

package.json 中用于检查入口点的字段。基于平台的默认值：

¥Fields in package.json to check for entry points. Defaults based on platform:

  • Node：['main', 'module']

  • 浏览器：['browser', 'module', 'main']

    ¥Browser: ['browser', 'module', 'main']

  • 中立：[]（依赖于 exports 字段）

    ¥Neutral: [] (relies on exports field)

mainFiles ​

  • 类型：string[]

    ¥Type: string[]

  • 默认值：['index']

    ¥Default: ['index']

  • 路径：resolve.mainFiles

    ¥Path: resolve.mainFiles

解析目录时要尝试的文件名。

¥Filenames to try when resolving directories.

modules ​

  • 类型：string[]

    ¥Type: string[]

  • 默认值：['node_modules']

    ¥Default: ['node_modules']

  • 路径：resolve.modules

    ¥Path: resolve.modules

用于搜索模块的目录。

¥Directories to search for modules.

  • 类型：boolean

    ¥Type: boolean

  • 默认值：true

    ¥Default: true

  • 路径：resolve.symlinks

    ¥Path: resolve.symlinks

解析模块时是否遵循符号链接。

¥Whether to follow symlinks when resolving modules.