# bun run 基础

URL: https://caijiao.org/bun/script/basic
Source: docs/bun/script/basic.md
Description: 本章节介绍了如何使用 'bun run' 命令运行项目中的脚本，帮助开发者更高效地执行自定义任务和脚本。

`bun run` 是 Bun 中用于执行项目中自定义脚本的命令，类似于其他工具中的 `npm run` 或 `yarn run`。通过 `bun run`，开发者可以执行定义在 `package.json` 文件中的脚本任务，如构建、测试、启动等操作。

## 1. 运行定义的脚本

在 `package.json` 文件中的 `scripts` 部分，可以定义项目的自定义命令。例如：

```json
{
  "scripts": {
    "build": "bun build",
    "start": "bun dev",
    "test": "bun test"
  }
}
````

在这种情况下，可以使用 `bun run` 来执行这些脚本：

```bash
bun run build
bun run start
bun run test
```

这些命令分别对应着构建、启动和测试的任务。

## 2. 使用命令行参数

`bun run` 支持向脚本传递命令行参数。比如，如果你定义了一个接受参数的脚本，可以直接传入这些参数：

```bash
bun run build --prod
```

这将会传递 `--prod` 参数给 `bun build` 命令，告诉 Bun 进行生产环境构建。

## 3. 运行自定义脚本

除了 `package.json` 中的标准脚本外，`bun run` 还可以执行任何自定义的 Node.js 脚本。例如，假设你有一个名为 `custom-script.js` 的文件，你可以通过以下方式执行它：

```bash
bun run custom-script.js
```

这允许你轻松地运行自定义任务，而无需创建额外的 `npm` 或 `yarn` 配置。

## 4. 与其他命令结合使用

`bun run` 不仅限于运行 `package.json` 中定义的脚本，它还可以与其他 [Bun](/bun/) 命令结合使用。例如，可以通过 `bun run` 启动一个开发服务器：

```bash
bun run dev --host 0.0.0.0
```

这可以确保开发服务器绑定到所有网络接口，从而让其他设备也能够访问。

## 总结

通过 `bun run`，开发者能够快速执行项目中的自定义任务和脚本。结合 Bun 的高效性能，`bun run` 使得脚本执行更加简便和灵活，从而提高开发效率。