dev.startUrl#

• 类型： boolean | string | string[] | undefined
• 默认值： undefined

dev.startUrl 用于配置一组页面 URL，Rsbuild 会在启动 server 后自动在浏览器中打开这些页面。

你也可以使用 Rsbuild CLI 的 --open 选项来打开页面。

示例#

dev.startUrl 可以设置为如下的值。

• 打开项目的默认页面，等价于 http://localhost:<port>：

export default {
  dev: {
    startUrl: true,
  },
};

• 打开指定的页面：

export default {
  dev: {
    startUrl: 'http://localhost:3000',
  },
};

• 打开多个页面：

export default {
  dev: {
    startUrl: ['http://localhost:3000', 'http://localhost:3000/about'],
  },
};

端口号占位符#

由于端口号可能会发生变动，你可以使用 <port> 占位符来指代当前端口号，Rsbuild 会自动将占位符替换为实际监听的端口号。

export default {
  dev: {
    startUrl: 'http://localhost:<port>/home',
  },
};

打开指定浏览器#

Rsbuild 默认会在当前系统的默认浏览器中打开页面。

在 macOS 上，通过设置环境变量 BROWSER，你可以指定 Dev Server 在启动时打开的浏览器，支持如下的值：

• Google Chrome Canary
• Google Chrome Dev
• Google Chrome Beta
• Google Chrome
• Microsoft Edge
• Brave Browser
• Vivaldi
• Chromium

比如：

BROWSER="Google Chrome Canary" npx rsbuild dev --open